Skip to main content
Confirms a pending agent signup. If the sponsor has an existing Firecrawl account, the key is merged into it. If not, the sandboxed account is promoted to a full account under the sponsor’s email. No authentication required — the verification token acts as proof.

​
Headers

HeaderValue
Content-Typeapplication/json

​
Request Body

ParameterTypeRequiredDescription
agent_signup_tokenstringYesThe verification token from the confirmation email link.

​
Response

FieldTypeDescription
successbooleanWhether the confirmation succeeded
messagestringHuman-readable result message

​
Example Request

curl -X POST "https://api.firecrawl.dev/v2/agent-signup/confirm" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_signup_token": "a1b2c3d4..."
  }'

​
Example Response

{
  "success": true,
  "message": "Agent key confirmed and linked to your account."
}

​
What Happens on Confirm

  • Existing account: The agent’s API key is moved to the sponsor’s team. The sandboxed account is deactivated.
  • No account: The sandboxed account’s email is updated to the sponsor’s email, becoming their real account.
  • In both cases, the 50-credit cap is removed and the key inherits the sponsor’s full plan.

​
Error Responses

StatusErrorWhen
400Invalid requestMissing agent_signup_token
403Verification deadline has passedThe 5-day confirmation window expired
403This agent signup has been blockedThe sponsor already blocked this key
404Invalid or expired verification tokenToken not found or already used