Skip to main content

​
Quickest start

Sign up your agent and get an API key in a single API call — no dashboard, no browser, no human in the loop. This one-liner signs up a fresh agent+ address and exports the returned key to $RECOUP_API_KEY: 
export RECOUP_API_KEY=$(curl -s -X POST "https://api.recoupable.com/api/agents/signup" \
  -H "Content-Type: application/json" \
  -d '{"email": "agent+'$(date +%s)-$RANDOM'@recoupable.com"}' | jq -r .api_key)
Verify it worked: 
curl -H "x-api-key: $RECOUP_API_KEY" https://api.recoupable.com/api/accounts/id
The agent+{timestamp}@recoupable.com shape is the fastest path for agents — it guarantees a fresh agent+ address and returns an API key instantly without email verification.
For the full signup + email-verification flow, see the Agents guide.

​
Base URL

All API requests should be made to: 
https://api.recoupable.com/api

​
Your First Request

Once you have an API key, include it in the x-api-key header on every request. Here’s a simple call that retrieves your scheduled tasks: 
curl -X GET "https://api.recoupable.com/api/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"
Example Response: 
{
  "status": "success",
  "tasks": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Daily Fan Report",
      "prompt": "Generate a summary of new fans from the past 24 hours",
      "schedule": "0 9 * * *",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "artist_account_id": "987fcdeb-51a2-3b4c-d5e6-789012345678",
      "enabled": true
    }
  ]
}
For full documentation on the Tasks API including filtering options, see the Tasks API Reference.

​
Prefer the dashboard?

If you’re a human building an integration, you can also create API keys from the web console instead of the signup endpoint:
  1. Navigate to the Recoup API Keys Management Page
  2. Sign in with your account
  3. Enter a descriptive name (e.g. “Production Server”)
  4. Click Create API Key
Copy and securely store your API key immediately — it will only be shown once.

​
Next Steps

With your API key ready, you can now:

Artist Data

Fetch artist profiles and social accounts.

Fan Analytics

Access fan data across all connected social platforms.

Chat API

Build AI-powered conversations with artist context.

Task Management

Schedule and automate recurring tasks.

​
Support

If you need help or have questions about the API, please contact our support team at agent@recoupable.com.