Skip to main content
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

HeaderValue
Content-Typeapplication/json

​
Request Body

ParameterTypeRequiredDescription
emailstringYesEmail address of the human sponsor. Must be a valid email.
agent_namestringYesName of the agent creating the key (1–100 characters). Shown in the verification email.
accept_termsbooleanYesMust be true. Acknowledges the Terms of Service.

​
Response

FieldTypeDescription
successbooleanWhether the key was created
api_keystringThe provisioned API key (starts with fc-)
sponsor_statusstringAlways "pending" on creation
credit_limitnumberMaximum credits available before verification (50)
credits_remainingnumberCredits remaining (50 on creation)
verification_deadline_atstringISO 8601 timestamp. The sponsor must confirm before this deadline (5 days).
tos_urlstringURL 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": "user@company.com",
    "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

StatusErrorWhen
400Invalid request bodyMissing or invalid fields
403This email has blocked agent signupsThe sponsor previously blocked agent signups
403Previous agent signup verification has expiredA previous signup expired; sponsor should log in
409A pending agent signup confirmation has already been sentA key is already pending for this email