> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-abimaelmartell-agent-default-model.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/features/agent-signup).

## 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](https://firecrawl.dev/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

```bash theme={null}
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

```json theme={null}
{
  "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          |