Skip to main content
POST
/
api
/
connectors
cURL
curl --request POST \
  --url https://recoup-api.vercel.app/api/connectors \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "connector": "<string>",
  "callback_url": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "success": true,
  "data": {
    "connector": "<string>",
    "redirectUrl": "<string>"
  }
}

Authorizations

​
x-api-key
string
header
required

Your Recoup API key. Learn more.

Body

application/json

Authorization request details

​
connector
string
required

The connector slug to authorize (e.g., 'googlesheets', 'tiktok')

​
callback_url
string<uri>

Optional custom callback URL after OAuth completion

​
account_id
string<uuid>

Optional account ID to connect a service for a different account (e.g., an artist, workspace, or organization). Use this when connecting an artist's TikTok or other service. The authenticated account must have access. Omit to connect for your own account.

Response

Authorization URL generated successfully

​
success
boolean
required
​
data
object
required