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

# Clés API

> Créez une clé API pour connecter Make ou vos propres outils à l'API Setteo, et révoquez-la quand vous n'en avez plus besoin.

Une clé API permet à un outil de lire et de modifier votre compte Setteo par l'API. Make l'utilise pour se connecter, et vos développeurs l'utilisent pour leurs propres intégrations.

> [!WARNING]
>
> Une clé lit tous les prospects et toutes les conversations du compte, et peut les modifier. Ne la partagez qu'avec les outils qui en ont besoin.

## Créer une clé

**1. Ouvrez les automatisations**

Dans **Configuration > Intégrations**, ouvrez l'onglet **Automatisations**.

**2. Créez la clé**

Dans **Clés API**, cliquez sur **Créer une clé**. Donnez un **Nom** qui dit à quoi elle sert, par exemple « Automatisation des prospects ».

**3. Choisissez son expiration**

Dans **Expire dans**, choisissez 30, 90 ou 180 jours. Une clé n'est jamais illimitée.

**4. Copiez-la tout de suite**

Copiez la clé, puis cliquez sur **J'ai copié la clé**. Elle ne sera plus jamais affichée.

![La fenêtre Votre clé API, avec la clé affichée une seule fois](https://mintcdn.com/setteo-397937b0/HWCbcrkIIE1ompbN/images/integrations/cle-api-creee.png?fit=max\&auto=format\&n=HWCbcrkIIE1ompbN\&q=85\&s=5fddfaf8cb39735700adc47a5bdcaf45)

> [!NOTE]
>
> Seul le **Propriétaire** peut créer une clé. Tous les Propriétaires du compte reçoivent un e-mail de sécurité à chaque création.

## Suivre et révoquer vos clés

La liste **Clés API** montre pour chaque clé qui l'a créée, sa dernière utilisation et sa date d'expiration.

* **Révoquer** coupe l'accès immédiatement pour tout outil qui utilise la clé. C'est irréversible.
* Une clé **Expirée** ne fonctionne plus. Créez-en une nouvelle et remplacez-la dans vos outils.

> [!TIP]
>
> Créez une clé par outil. Si vous arrêtez un outil, vous révoquez sa clé sans couper les autres.

## Ce que la clé permet

L'API est à l'adresse `https://api.setteo.io/v1`. Chaque requête porte la clé dans l'en-tête `Authorization: Bearer <clé>`.

Elle donne accès à :

* les prospects et leurs tags ;
* les tags ;
* les scénarios et les prospects qui y sont inscrits ;
* les liens courts et leurs statistiques ;
* les conversations et leurs messages.

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

La liste des points d'accès, des champs et des erreurs est dans la [référence de l'API](https://docs.setteo.io/api-reference/introduction.md). L'authentification est détaillée dans [Authentification](https://docs.setteo.io/api-reference/authentication.md).

## Webhook ou API ?

* Pour réagir à un événement en temps réel, utilisez un [webhook sortant](https://docs.setteo.io/integrations/webhooks-sortants.md).
* Pour envoyer un prospect depuis un formulaire ou un tunnel, utilisez un [webhook entrant](https://docs.setteo.io/integrations/webhooks-entrants.md) : pas besoin de clé.
* Pour lire ou modifier des données à la demande, utilisez l'API.

## Je ne trouve pas Clés API

**Intégrations** est réservée au rôle **Propriétaire**. Si vous êtes **Membre**, demandez à un Propriétaire de changer votre rôle. Voir [Compte et accès](https://docs.setteo.io/depannage/compte-et-acces.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.