Pular para o conteúdo principal
Provisiona imediatamente uma nova chave de API, em sandbox, com 50 créditos. Um email de verificação é enviado ao patrocinador. Não requer autenticação. Para uma visão geral completa do fluxo, consulte o guia de cadastro de agente.

​
Cabeçalhos

CabeçalhoValor
Content-Typeapplication/json

​
Corpo da requisição

ParâmetroTipoObrigatórioDescrição
emailstringSimEndereço de email do patrocinador humano. Deve ser um email válido.
agent_namestringSimNome do agente que cria a chave (1–100 caracteres). Exibido no email de verificação.
accept_termsbooleanSimDeve ser true. Indica a aceitação dos Termos de Serviço.

​
Resposta

CampoTipoDescrição
successbooleanIndica se a chave foi criada
api_keystringA API key provisionada (começa com fc-)
sponsor_statusstringSempre "pending" na criação
credit_limitnumberNúmero máximo de créditos disponíveis antes da verificação (50)
credits_remainingnumberCréditos restantes (50 na criação)
verification_deadline_atstringTimestamp no formato ISO 8601. O patrocinador deve confirmar até este prazo (5 dias).
tos_urlstringURL dos Termos de Serviço aceitos

​
Exemplo de requisição

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
  }'

​
Exemplo de resposta

{
  "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"
}

​
Respostas de erro

StatusErroQuando
400Corpo da requisição inválidoCampos ausentes ou inválidos
403Este email bloqueou cadastros de agenteO patrocinador bloqueou anteriormente os cadastros de agente
403A verificação de um cadastro anterior de agente expirouUm cadastro anterior expirou; o patrocinador deve fazer login
409Uma confirmação pendente de cadastro de agente já foi enviadaJá existe uma chave pendente para este email