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

# Authentification

> Récupérer l'URL et le jeton de votre espace, et les envoyer avec chaque requête.

## Récupérer l'URL et le jeton

<Steps>
  <Step title="Ouvrez les réglages">
    Dans ScaleFlow, allez dans **Réglages → Tags & Webhook**, section **Webhook CRM (ingestion de leads)**.
  </Step>

  <Step title="Générez le webhook">
    Cliquez sur **Générer le webhook**. Cette action est réservée aux administrateurs de l'espace.
  </Step>

  <Step title="Copiez le jeton tout de suite">
    Le jeton n'est affiché **qu'une seule fois**. ScaleFlow n'en garde qu'une empreinte et ne peut pas vous le réafficher. Rangez-le dans le coffre-fort de secrets de votre outil.
  </Step>

  <Step title="Copiez l'URL">
    L'URL affichée contient déjà l'identifiant de votre endpoint, par exemple : `https://api.scaleflow.fr/webhooks/ingest-lead?endpoint_id=3f6c…`
  </Step>
</Steps>

L'`endpoint_id` n'est pas un secret : il désigne votre espace. Le secret, c'est le jeton.

## Envoyer le jeton

Passez le jeton dans l'en-tête `Authorization` :

```bash theme={null}
curl -X POST "https://api.scaleflow.fr/webhooks/ingest-lead?endpoint_id=VOTRE_ENDPOINT_ID" \
  -H "Authorization: Bearer VOTRE_JETON" \
  -H "Content-Type: application/json" \
  -d '{"email": "jean.dupont@example.com"}'
```

Emplacements acceptés, du plus recommandé au moins recommandé :

| Donnée | Emplacement |
| - | - |
| Jeton | en-tête `Authorization: Bearer <jeton>` |
| Jeton | en-tête `x-webhook-token: <jeton>` |
| Jeton | paramètre d'URL `?token=<jeton>` |
| Identifiant d'endpoint | paramètre d'URL `?endpoint_id=<uuid>`, déjà présent dans l'URL copiée depuis ScaleFlow |

Si un en-tête porte un jeton, le paramètre `?token=` n'est pas lu.

<Warning>
  N'utilisez `?token=` que si votre outil ne sait pas poser d'en-tête (certains scénarios Tally ou Make). Un jeton dans l'URL peut apparaître dans des journaux d'accès intermédiaires.
</Warning>

## Régénérer le jeton

Si un jeton a fuité, cliquez sur **Régénérer le token** dans le même écran. L'ancien jeton cesse de fonctionner **immédiatement** : mettez à jour toutes vos intégrations juste après.

Un jeton permet uniquement d'**envoyer** des leads et des candidatures dans votre espace. Il ne donne aucun accès en lecture à vos données.

## Suivre l'activité

L'écran **Tags & Webhook** indique si le webhook est actif et la date du **dernier appel** reçu.


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