PayAHuman
Send payouts to creators by email address or social media handle using the Talentir payment platform.
Setup
- Create a business account at https://www.talentir.com/start/business
- Get your API key from the Talentir dashboard
- Set the environment variable:
bash export TALENTIR_API_KEY="your-api-key"
API Basics
All requests need:
curl -s "https://www.talentir.com/api/v1/..." \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json"
Payouts
Create a payout by email
curl -s -X POST "https://www.talentir.com/api/v1/payout" \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "Payment for services",
"email": "creator@example.com",
"payoutAmount": "100.00",
"currency": "EUR",
"handleType": "none"
}' | jq
Create a payout by social media handle
Supported platforms: tiktok, instagram, youtube-channel.
curl -s -X POST "https://www.talentir.com/api/v1/payout" \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "Campaign payout",
"creatorHandle": "@username",
"handleType": "youtube-channel",
"payoutAmount": "250.00",
"currency": "USD"
}' | jq
Create a payout with tags and custom ID
curl -s -X POST "https://www.talentir.com/api/v1/payout" \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "Q1 royalty payment",
"email": "creator@example.com",
"payoutAmount": "500.00",
"currency": "USD",
"handleType": "none",
"tags": ["royalties", "q1-2025"],
"customId": "INV-2025-001"
}' | jq
Get a payout by ID
curl -s "https://www.talentir.com/api/v1/payout/{id}" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
Get a payout by custom ID
curl -s "https://www.talentir.com/api/v1/payout/{customId}?id_type=custom_id" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
List payouts
curl -s "https://www.talentir.com/api/v1/payouts?limit=20&order_direction=desc" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
Team
Get team info
curl -s "https://www.talentir.com/api/v1/team" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
Webhooks
List webhooks
curl -s "https://www.talentir.com/api/v1/webhook" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
Create a webhook
curl -s -X POST "https://www.talentir.com/api/v1/webhook" \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"targetUrl": "https://your-server.com/webhook",
"eventType": "payout",
"environment": "production"
}' | jq
Save the returned signingSecret securely - it won't be shown again.
Delete a webhook
curl -s -X DELETE "https://www.talentir.com/api/v1/webhook/{id}" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
Payout Fields Reference
| Field | Required | Description |
|---|---|---|
description | Yes | Reason for the payout |
payoutAmount | Yes | Amount as string (minimum "0.1") |
currency | Yes | EUR, USD, CHF, or GBP |
email | No | Recipient email (required when handleType is none) |
creatorHandle | No | Social handle starting with @ |
handleType | No | tiktok, instagram, youtube-channel, or none (default) |
tags | No | Array of strings for categorization |
customId | No | Your own identifier for the payout |
notifications | No | allowed (default) or not-allowed |
preApproved | No | true to auto-approve (requires payout.api_approve permission) |
Payout Statuses
created → approved → requested → completed
A payout can also become deleted or expired at any point.
Notes
- Amounts are strings (e.g.
"100.00", not100) - Minimum payout amount is
"0.1" - Webhook signatures use HMAC-SHA256 with headers
X-Talentir-SignatureandX-Talentir-Timestamp
