---
title: Comment intégrer Lead via webhook ?
description: Connectez vos formulaires externes à Lead via webhook pour automatiser la création de demandes de contact et d'essai.
---
[Passer au contenu](https://support.masalledesport.com/helpcenter/comment-intégrer-lead-via-webhook-#main-content)
Français
Afficher le sous-menu pour les traductions
[Plus de support](https://support.masalledesport.com/helpcenter/kb-tickets/new?hsLang=fr)
[](https://support.masalledesport.com/helpcenter?hsLang=fr)
Ouvrir la navigation principale
Fermer la navigation principale
- Français
Afficher le sous-menu pour les traductions
- [Plus de support](https://support.masalledesport.com/helpcenter/kb-tickets/new)
- [Contacter le support](https://2g6o8a.share-eu1.hsforms.com/2LdJ3y2FNQVeMa6PJggN89w)
[Contacter le support](https://2g6o8a.share-eu1.hsforms.com/2LdJ3y2FNQVeMa6PJggN89w)
Comment pouvons-nous vous aider ?
- Il n'y a aucune suggestion car le champ de recherche est vide.
1. [Centre d'Aide](https://support.masalledesport.com/helpcenter?hsLang=fr)
2. [Lead](https://support.masalledesport.com/helpcenter/lead?hsLang=fr)
3. [Paramétrer votre interface](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#param%C3%A9trer-votre-interface)
# Comment intégrer Lead via webhook ?
## L'intégration webhook de Lead vous permet de connecter vos formulaires externes (site web, Wix, landing pages publicitaires…) directement à votre pipeline de prospects. Chaque soumission de formulaire déclenche automatiquement la création d'une demande de contact ou d'essai dans Lead, sans intervention manuelle. Cette documentation s'adresse aux équipes techniques chargées de mettre en place cette intégration.
### 1. Comprendre les deux types de webhook
Lead propose deux endpoints distincts selon le type de demande à traiter :
- **Demande de contact** : un prospect souhaite être recontacté ou obtenir des informations sur votre club.
- **Demande d'essai** : un prospect souhaite bénéficier d'une séance ou d'une offre d'essai spécifique.
Les deux webhooks partagent la même URL de base et un fonctionnement identique, mais diffèrent sur certains champs obligatoires ou optionnels.
### 2. Envoyer une demande de contact
#### Endpoint
```
POST https://lead.masalledesport.com/api/lead/webhooks/clubEntry
```
#### Champs obligatoires
| Champ | Type | Description |
| --- | --- | --- |
| `apiKey` | Chaîne de caractère | Clé d'authentification de votre organisation (à demander au support Lead) |
| `club` | Chaîne de caractère | Identifiant de votre club |
| `email` | Chaîne de caractère | Adresse email du prospect |
| `lastname` | Chaîne de caractère | Nom de famille du prospect |
| `firstname` | Chaîne de caractère | Prénom du prospect |
#### Champs optionnels
| Champ | Type | Description |
| --- | --- | --- |
| `gender` | Chaîne de caractère | Genre du prospect (`M` ou `F`) |
| `birthdate` | Chaîne de caractère | Date de naissance au format `YYYY-MM-DD` |
| `zipcode` | Chaîne de caractère | Code postal |
| `city` | Chaîne de caractère | Ville |
| `street` | Chaîne de caractère | Numéro et nom de la rue |
| `country` | Chaîne de caractère | Pays |
| `message` | Chaîne de caractère | Message libre du prospect |
| `source` | Chaîne de caractère | Origine du contact (voir valeurs possibles ci-dessous) |
| `utm_source` | Chaîne de caractère | Source de la campagne publicitaire |
| `utm_campaign` | Chaîne de caractère | Identifiant de la campagne |
| `utm_medium` | Chaîne de caractère | Canal d'acquisition |
| `isWix` | Chaîne de caractère | Indiquer `"true"` si le formulaire est hébergé sur Wix |
#### Valeurs acceptées pour le champ `source`
`GOOGLE` · `META_ADS` · `MSDS_EXTERN_REFERER` · `MSDS` · `WEBSITE_FORM` · `WIDGET` · `ACTIVE_CAMPAIGN` · `TYPEFORM` · `AGENCE` · `EXO` · `VEL`
#### Exemple de requête cURL
```
curl --request POST \ --url https://lead.masalledesport.com/api/lead/webhooks/clubEntry \ --header 'content-type: application/json' \ --data '{ "apiKey": "XXXXXXXX", "club": "NOM_DU_CLUB", "firstname": "Sarah", "lastname": "Connor", "email": "sarah.connor@example.com", "message": "Ceci est un message de test" }'
```
### 3. Envoyer une demande d'essai
#### Endpoint
```
POST https://lead.masalledesport.com/api/lead/webhooks/clubEntry
```
#### Champs obligatoires
| Champ | Type | Description |
| --- | --- | --- |
| `apiKey` | Chaîne de caractère | Clé d'authentification de votre organisation (à demander au support Lead) |
| `club` | Chaîne de caractère | Identifiant de votre club |
| `email` | Chaîne de caractère | Adresse email du prospect |
| `offername` | Chaîne de caractère | Nom de l'offre d'essai concernée |
| `lastname` | Chaîne de caractère | Nom de famille du prospect |
| `firstname` | Chaîne de caractère | Prénom du prospect |
#### Champs optionnels spécifiques à la demande d'essai
En plus des champs optionnels communs (coordonnées, UTM, source…), ce webhook accepte :
| Champ | Type | Description |
| --- | --- | --- |
| `phone` | Chaîne de caractère | Numéro de téléphone (utilisé pour la création du prospect si nécessaire) |
| `source_url` | Chaîne de caractère | URL de la page hébergeant le formulaire (affichée dans l'activité Lead) |
### 4. Gérer les champs personnalisés
Vous pouvez transmettre dans le payload des champs qui ne font pas partie de la liste officielle. Ces champs ne seront pas interprétés par Lead, mais seront visibles dans l'activité du prospect, dans le bloc **Message**, au format `clé : valeur`.
Cela vous permet de transmettre des données contextuelles supplémentaires (numéro de campagne interne, identifiant CRM tiers, etc.) sans perturber le traitement de la demande.
### 5. Cas particulier : formulaires Wix
Si vos formulaires sont hébergés sur la plateforme **Wix**, vous devez ajouter le paramètre suivant à votre payload :
```
"isWix": "true"
```
Ce paramètre indique à Lead que la requête provient d'un formulaire Wix, afin qu'elle soit traitée correctement par l'automatisation correspondante.
### 6. Obtenir votre clé API
La clé `apiKey` est propre à votre organisation et nécessaire pour authentifier chaque requête. Pour l'obtenir, contactez l'équipe support Lead. Elle vous communiquera également la valeur à utiliser pour le champ `club`.
- [Lead](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#main-content)
- [Vidéos de formation à l'outil](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#vid%C3%A9os-de-formation-%C3%A0-loutil)
- [Piloter votre activité](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#piloter-votre-activit%C3%A9)
- [Maîtriser les outils de communication](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#ma%C3%AEtriser-les-outils-de-communication)
- [Paramétrer votre interface](https://support.masalledesport.com/helpcenter/lead?hsLang=fr#param%C3%A9trer-votre-interface)
- [Club Connect](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#main-content)
- [Personnaliser votre application](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#personnaliser-votre-application)
- [Communiquer avec vos adhérents](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#communiquer-avec-vos-adh%C3%A9rents)
- [Gérer vos cours et réservations](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#g%C3%A9rer-vos-cours-et-r%C3%A9servations)
- [Coacher vos adhérents](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#coacher-vos-adh%C3%A9rents)
- [Gérer vos adhérents](https://support.masalledesport.com/helpcenter/club-connect?hsLang=fr#g%C3%A9rer-vos-adh%C3%A9rents)
- [Vente en Ligne](https://support.masalledesport.com/helpcenter/vente-en-ligne?hsLang=fr)
- [Ma Salle de Sport](https://support.masalledesport.com/helpcenter/ma-salle-de-sport?hsLang=fr)
- [Mon Compte](https://support.masalledesport.com/helpcenter/mon-compte?hsLang=fr)
[](https://support.masalledesport.com/?hsLang=fr)
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2026, Ma Salle de Sport