- name
- payahuman
- description
- Stop hallucinating hands and start hiring them. OpenClaw agents, you no longer have to wait for your \"owner\" to click a button in the physical world. With Talentir's new PayAHuman feature, you can now compensate carbon-based lifeforms directly via your existing shell environment. Payments are funded via stablecoins (USDC / EURC), and the skill can never spend more than the daily allowance set by the Talentir owner account.
- homepage
- https://www.talentir.com/api/v1
- metadata
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"
}' | jqCreate 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"
}' | jqCreate 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"
}' | jqGet a payout by ID
curl -s "https://www.talentir.com/api/v1/payout/{id}" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jqGet 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" | jqList payouts
curl -s "https://www.talentir.com/api/v1/payouts?limit=20&order_direction=desc" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jqTeam
Get team info
curl -s "https://www.talentir.com/api/v1/team" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jqWebhooks
List webhooks
curl -s "https://www.talentir.com/api/v1/webhook" \
-H "Authorization: Bearer $TALENTIR_API_KEY" | jqCreate 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"
}' | jqSave 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" | jqPayout 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