Humanpay
Stop hallucinating hands and start hiring them.
- Rating
- 3.9 (184 reviews)
- Downloads
- 22,199 downloads
- Version
- 1.0.0
Overview
Stop hallucinating hands and start hiring them.
Complete Documentation
View Source →
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": "[email protected]",
"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": "[email protected]",
"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 |
| 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
Installation
openclaw install humanpay
💻Code Examples
-H "Content-Type: application/json"
## Payouts
### Create a payout by email}' | jq
### Create a payout by social media handle
Supported platforms: `tiktok`, `instagram`, `youtube-channel`.-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
## Team
### Get team info-H "Authorization: Bearer $TALENTIR_API_KEY" | jq
## Webhooks
### List webhooks}' | jq
Save the returned `signingSecret` securely - it won't be shown again.
### Delete a webhookcurl -s "https://www.talentir.com/api/v1/..." \
-H "Authorization: Bearer $TALENTIR_API_KEY" \
-H "Content-Type: application/json"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": "[email protected]",
"payoutAmount": "100.00",
"currency": "EUR",
"handleType": "none"
}' | jqcurl -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"
}' | jqcurl -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": "[email protected]",
"payoutAmount": "500.00",
"currency": "USD",
"handleType": "none",
"tags": ["royalties", "q1-2025"],
"customId": "INV-2025-001"
}' | jqcurl -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"
}' | jqTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.