**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Authentification

Une clé, un périmètre et des permissions explicites.

Transmettez votre clé dans Authorization: Bearer ou X-API-Key. Ne la placez jamais dans une URL ni dans le code public d’un site.

```shell
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEY
```

Une clé ke_live_ est rattachée à une seule organisation. Les permissions de lecture, d’écriture et d’envoi sont distinctes. Chaque opération indique les permissions acceptées.

## Comprendre une erreur

401 MISSING_API_KEY ou INVALID_API_KEY : vérifiez la clé, l’en-tête et l’environnement. 403 INSUFFICIENT_SCOPE : vérifiez les permissions requises par l’opération.

Les autres erreurs métier sont décrites par opération. Conservez le code HTTP et le champ error pour diagnostiquer un échec.

Après un délai d’attente sur une écriture ou un envoi, vérifiez le résultat avant de réessayer : toutes les opérations ne sont pas idempotentes.
