Confirm Agent Signup

Verify and link an agent-provisioned API key to the sponsor’s account.

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

Header	Value
Content-Type	application/json

Request Body

Parameter	Type	Required	Description
agent_signup_token	string	Yes	The verification token from the confirmation email link.

Response

Field	Type	Description
success	boolean	Whether the confirmation succeeded
message	string	Human-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

Status	Error	When
400	Invalid request	Missing agent_signup_token
403	Verification deadline has passed	The 5-day confirmation window expired
403	This agent signup has been blocked	The sponsor already blocked this key
404	Invalid or expired verification token	Token not found or already used