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:
```
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", not 100)
Minimum payout amount is "0.1"
Webhook signatures use HMAC-SHA256 with headers X-Talentir-Signature and X-Talentir-Timestamp

payahuman

Safety Notice

Copy this and send it to your AI assistant to learn