Quickstart

Connect first

Use MCP OAuth for a supported AI host. For the REST examples below, create a personal API key in account settings or follow the Agents email verification guide. Store the key as RECOUP_API_KEY through your secret facility or an approved environment file. Never paste credentials into agent instructions or create a disposable account to access an existing customer's data.

Verify the REST credential before continuing:

curl --fail-with-body -sS -H "x-api-key: $RECOUP_API_KEY" \
  https://api.recoupable.dev/api/accounts/id

Base URL

For a language client, use the Recoup SDK guide. It includes the published Go package, Python source installation, and the Node CLI.

All API requests should be made to:

https://api.recoupable.dev/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.dev/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
    }
  ]
}

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

Next Steps

With your API key ready, you can now:

Support

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