Agent Signup

Create a sandboxed Firecrawl API key on behalf of a human sponsor.

Provisions a new API key immediately, sandboxed with 50 credits. A verification email is sent to the sponsor. No authentication required.

For a full overview of the flow, see the Agent Signup guide.

Headers

Header	Value
Content-Type	application/json

Request Body

Parameter	Type	Required	Description
email	string	Yes	Email address of the human sponsor. Must be a valid email.
agent_name	string	Yes	Name of the agent creating the key (1–100 characters). Shown in the verification email.
accept_terms	boolean	Yes	Must be true. Acknowledges the Terms of Service.

Response

Field	Type	Description
success	boolean	Whether the key was created
api_key	string	The provisioned API key (starts with fc-)
sponsor_status	string	Always "pending" on creation
credit_limit	number	Maximum credits available before verification (50)
credits_remaining	number	Credits remaining (50 on creation)
verification_deadline_at	string	ISO 8601 timestamp. The sponsor must confirm before this deadline (5 days).
tos_url	string	URL to the accepted Terms of Service

Example Request

curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[e-mail]",
    "agent_name": "Research Assistant",
    "accept_terms": true
  }'

Example Response

{
  "success": true,
  "api_key": "fc-abc123...",
  "sponsor_status": "pending",
  "credit_limit": 50,
  "credits_remaining": 50,
  "verification_deadline_at": "2026-03-23T12:00:00.000Z",
  "tos_url": "https://firecrawl.dev/terms-of-service"
}

Error Responses

Status	Error	When
400	Invalid request body	Missing or invalid fields
403	This email has blocked agent signups	The sponsor previously blocked agent signups
403	Previous agent signup verification has expired	A previous signup expired; sponsor should log in
409	A pending agent signup confirmation has already been sent	A key is already pending for this email