> ## Documentation Index
> Fetch the complete documentation index at: https://docs.setteo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authentifiez vos requêtes avec un token Bearer.

Générez vos tokens API depuis la page **Intégrations** de votre espace de travail Setteo.

## Créer un token API

<Steps>
  <Step title="Ouvrez Intégrations">
    Dans votre espace Setteo, ouvrez **Intégrations**.
  </Step>

  <Step title="Créez un token">
    Dans la section **Jetons API**, cliquez sur **Créer un jeton**.
  </Step>

  <Step title="Nommez le token">
    Donnez un nom au token pour le reconnaître plus tard.
  </Step>

  <Step title="Choisissez l'expiration">
    Sélectionnez **Jamais**, **30 jours** ou **90 jours**.
  </Step>

  <Step title="Copiez le token">
    Copiez le token immédiatement. Pour des raisons de sécurité, il n'est affiché qu'une seule fois.
  </Step>
</Steps>

Ajoutez ensuite le token dans l'en-tête `Authorization` de chaque requête.

```text theme={null}
Authorization: Bearer <token>
```

## Exemple

```bash theme={null}
curl --request GET \
  --url https://api.setteo.io/v1/leads \
  --header 'Authorization: Bearer <token>' \
  --header 'Accept: application/json'
```

## Erreurs d'authentification

| Code  | Cause                                                                    |
| ----- | ------------------------------------------------------------------------ |
| `401` | Le token est absent, invalide ou expiré.                                 |
| `403` | Le token est valide, mais il ne donne pas accès à la ressource demandée. |

## Révoquer un token

Vous pouvez révoquer un token depuis la section **Jetons API** de la page **Intégrations**. Toute intégration qui utilise ce token perd immédiatement l'accès à l'API.