PayAHuman

Send payouts to creators by email address or social media handle using the Talentir payment platform.

Setup

1. Create a business account at https://www.talentir.com/start/business
2. Get your API key from the Talentir dashboard
3. 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