Skip to main content
POST
/
api
/
agents
/
signup
cURL
curl --request POST \
  --url https://recoup-api.vercel.app/api/agents/signup \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "agent+mybot@example.com"
}
'
{
  "account_id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "If this is a new agent+ email, your API key is included. Otherwise, check your email for a verification code.",
  "api_key": "recoup_sk_abc123..."
}

Body

application/json

Agent email to register

​
email
string<email>
required

The agent email address. Emails with the agent+ prefix (e.g. agent+mybot@example.com) get an API key immediately on first signup.

Example:

"agent+mybot@example.com"

Response

200 - application/json

Signup processed successfully

​
account_id
string<uuid>
required

The account ID for the registered agent.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
message
string
required

Human-readable status message.

Example:

"If this is a new agent+ email, your API key is included. Otherwise, check your email for a verification code."

​
api_key
string | null

API key returned immediately for new agent+ prefix emails. Null for all other cases — check your email for a verification code.

Example:

"recoup_sk_abc123..."