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

# Inscription d’agent

> Permet aux agents IA de créer par programmation des clés API Firecrawl au nom d’un humain référent.

L’Inscription d’agent permet aux agents IA de créer des clés API Firecrawl par programmation — sans navigateur, sans OAuth et sans humain dans la boucle au moment de la création. L’agent fournit l’e-mail d’un humain, et Firecrawl provisionne une clé API isolée qui fonctionne immédiatement avec une limite de 50 crédits. L’humain reçoit un e-mail pour confirmer ou bloquer la clé.

<Info>
  **Aucune authentification requise.** Le point de terminaison `/agent-signup` est public. Les agents n’ont pas besoin d’une clé API existante pour l’appeler.
</Info>

<div id="how-it-works">
  ## Comment ça marche
</div>

1. **Agent appelle `POST /v2/agent-signup`** avec l’e-mail de l’utilisateur, le nom de l’agent et `accept_terms: true`.
2. **Firecrawl renvoie immédiatement une clé API**. La clé est placée en sandbox avec **50 crédits** et limitée au seul scraping d’index jusqu’à confirmation du sponsor.
3. **L’utilisateur humain reçoit un e-mail** avec deux liens : **Confirmer & lier la clé** ou **Bloquer cette clé**.
4. **En cas de confirmation**, la clé en sandbox est fusionnée avec le compte Firecrawl existant de l’utilisateur (ou un nouveau compte est créé). La clé hérite des limites complètes de l’offre.
5. **En cas de blocage**, la clé est désactivée et l’e-mail est protégé contre de futures inscriptions non autorisées.

```
Agent                    Firecrawl                  Human
  │                         │                         │
  │── POST /agent-signup ──▶│                         │
  │◀── API key (sandboxed) ─│── verification email ──▶│
  │                         │                         │
  │   uses key (50 credits) │                         │
  │                         │                         │
  │                         │◀── confirm or block ────│
  │                         │                         │
  │   key upgraded to full  │                         │
  │   plan (if confirmed)   │                         │
```

<div id="for-agents">
  ## Pour les Agents
</div>

<div id="creating-a-key">
  ### Créer une clé
</div>

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

Réponse :

```json theme={null}
{
  "success": true,
  "api_key": "fc-...",
  "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"
}
```

Utilisez immédiatement l’`api_key` renvoyée pour le scraping, la recherche et les autres opérations de Firecrawl. La clé fonctionne immédiatement, mais elle est plafonnée à 50 credits jusqu’à confirmation par un humain.

<div id="handling-the-sandbox-limits">
  ### Gestion des limites du sandbox
</div>

Tant que `sponsor_status` est `"pending"` :

* La clé est soumise à un **plafond strict de 50 crédits**. Une fois ce plafond atteint, les requests renvoient `402` avec `error: "unverified_credit_limit_reached"`.
* Toutes les scrape requests sont limitées au **mode index-only** (sans rendu complet dans le navigateur).
* La clé expire si elle n’est pas confirmée dans un délai de **5 jours**.

Une fois que l’humain confirme, la clé passe à son offre complète, sans plafond de crédits ni restrictions de mode.

<div id="error-handling">
  ### Gestion des erreurs
</div>

| Statut | Erreur                                                      | Signification                                                   |
| ------ | ----------------------------------------------------------- | --------------------------------------------------------------- |
| `402`  | `unverified_credit_limit_reached`                           | Sandbox de 50 crédits épuisé. Demandez à l’humain de confirmer. |
| `403`  | `sponsor_verification_expired`                              | Le délai de 5 jours est dépassé sans confirmation.              |
| `403`  | `This API key has been blocked`                             | L’humain a bloqué la clé. Arrêtez de l’utiliser.                |
| `409`  | `A pending agent signup confirmation has already been sent` | Une clé est déjà en attente pour cet e-mail.                    |

<div id="for-humans">
  ## Pour les humains
</div>

Lorsqu’un agent crée une clé avec votre e-mail, vous recevez un e-mail avec deux options :

* **Confirmer et lier la clé** — Lie la clé de l’agent à votre compte Firecrawl. Si vous n’avez pas de compte, un compte est créé pour vous. La clé hérite des limites de votre offre.
* **Bloquer cette clé** — Désactive immédiatement la clé et empêche toute future inscription d’agent avec cet e-mail.

Vous pouvez également gérer les clés d’agent depuis le [Firecrawl dashboard](https://firecrawl.dev/signin). Si vous avez déjà un compte, vous verrez aussi une notification dans l’application.

<Warning>
  Si vous n’avez pas autorisé l’agent, cliquez immédiatement sur **Bloquer cette clé**. Cela révoque la clé et empêche toute utilisation ultérieure.
</Warning>

<div id="api-reference">
  ## Référence de l’API
</div>

| Point de terminaison                                                               | Description                           |
| ---------------------------------------------------------------------------------- | ------------------------------------- |
| [`POST /v2/agent-signup`](/fr/api-reference/endpoint/agent-signup)                 | Créer une clé API isolée              |
| [`POST /v2/agent-signup/confirm`](/fr/api-reference/endpoint/agent-signup-confirm) | Confirmer et lier une clé à un compte |
| [`POST /v2/agent-signup/block`](/fr/api-reference/endpoint/agent-signup-block)     | Bloquer et désactiver une clé         |