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

# Introduction

> Envoyez des leads et des candidatures dans votre espace ScaleFlow depuis vos formulaires, Make, Zapier ou n8n.

ScaleFlow expose des **webhooks entrants** : une adresse HTTPS à laquelle vos outils envoient des données, qui arrivent directement dans votre espace.

<CardGroup cols={2}>
  <Card title="Webhook leads" icon="user-plus" href="/webhooks/leads">
    Créez un prospect dans votre pipeline de vente depuis un formulaire, une landing page ou une publicité.
  </Card>

  <Card title="Webhook recrutement" icon="briefcase" href="/webhooks/recrutement">
    Envoyez une candidature dans votre pipeline de recrutement, avec les réponses du formulaire en note.
  </Card>
</CardGroup>

## Comment ça marche

1. Dans ScaleFlow, un administrateur génère le webhook de l'espace (**Réglages → Tags & Webhook**). Il obtient une URL et un jeton secret.
2. Votre outil envoie une requête `POST` en JSON à cette URL, avec le jeton.
3. ScaleFlow crée la fiche, ou la rattache à une fiche existante, et renvoie le résultat.

Un seul webhook par espace : le même jeton sert aux leads et aux candidatures.

## URL de base

```text theme={null}
https://api.scaleflow.fr
```

Tous les appels se font en HTTPS, avec un corps JSON (`Content-Type: application/json`).

## Pour commencer

<Steps>
  <Step title="Générez votre jeton">
    Suivez [Authentification](/authentification) pour récupérer l'URL et le jeton de votre espace.
  </Step>

  <Step title="Envoyez un premier lead">
    Copiez l'exemple de la page [Webhook leads](/webhooks/leads) et remplacez l'URL et le jeton.
  </Step>

  <Step title="Vérifiez la réponse">
    Lisez `status` et `warnings` dans la réponse : ils disent si le lead a été créé et où il a été placé. Voir [Erreurs et limites](/erreurs-et-limites).
  </Step>
</Steps>


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