> ## 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.

# Confirm Agent Signup

> Verify and link an agent-provisioned API key to the sponsor's account.

Confirms a pending agent signup. If the sponsor has an existing Firecrawl account, the key is merged into it. If not, the sandboxed account is promoted to a full account under the sponsor's email. No authentication required — the verification token acts as proof.

## Headers

| Header         | Value              |
| -------------- | ------------------ |
| `Content-Type` | `application/json` |

## Request Body

| Parameter            | Type   | Required | Description                                              |
| -------------------- | ------ | -------- | -------------------------------------------------------- |
| `agent_signup_token` | string | **Yes**  | The verification token from the confirmation email link. |

## Response

| Field     | Type    | Description                        |
| --------- | ------- | ---------------------------------- |
| `success` | boolean | Whether the confirmation succeeded |
| `message` | string  | Human-readable result message      |

### Example Request

```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/agent-signup/confirm" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_signup_token": "a1b2c3d4..."
  }'
```

### Example Response

```json theme={null}
{
  "success": true,
  "message": "Agent key confirmed and linked to your account."
}
```

## What Happens on Confirm

* **Existing account**: The agent's API key is moved to the sponsor's team. The sandboxed account is deactivated.
* **No account**: The sandboxed account's email is updated to the sponsor's email, becoming their real account.
* In both cases, the 50-credit cap is removed and the key inherits the sponsor's full plan.

## Error Responses

| Status | Error                                 | When                                  |
| ------ | ------------------------------------- | ------------------------------------- |
| `400`  | Invalid request                       | Missing `agent_signup_token`          |
| `403`  | Verification deadline has passed      | The 5-day confirmation window expired |
| `403`  | This agent signup has been blocked    | The sponsor already blocked this key  |
| `404`  | Invalid or expired verification token | Token not found or already used       |