Cadastro de agente

Crie uma chave de API do Firecrawl em sandbox em nome de um patrocinador humano.

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çalho	Valor
Content-Type	application/json

​

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
email	string	Sim	Endereço de email do patrocinador humano. Deve ser um email válido.
agent_name	string	Sim	Nome do agente que cria a chave (1–100 caracteres). Exibido no email de verificação.
accept_terms	boolean	Sim	Deve ser true. Indica a aceitação dos Termos de Serviço.

​

Resposta

Campo	Tipo	Descrição
success	boolean	Indica se a chave foi criada
api_key	string	A API key provisionada (começa com fc-)
sponsor_status	string	Sempre "pending" na criação
credit_limit	number	Número máximo de créditos disponíveis antes da verificação (50)
credits_remaining	number	Créditos restantes (50 na criação)
verification_deadline_at	string	Timestamp no formato ISO 8601. O patrocinador deve confirmar até este prazo (5 dias).
tos_url	string	URL 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": "[e-mail]",
    "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

Status	Erro	Quando
400	Corpo da requisição inválido	Campos ausentes ou inválidos
403	Este email bloqueou cadastros de agente	O patrocinador bloqueou anteriormente os cadastros de agente
403	A verificação de um cadastro anterior de agente expirou	Um cadastro anterior expirou; o patrocinador deve fazer login
409	Uma confirmação pendente de cadastro de agente já foi enviada	Já existe uma chave pendente para este email