// TROUVER ET SUIVRE SES PROSPECTS

Inscrire des prospects depuis un autre outil

Une clé d'API pour que Make, Zapier ou votre prestataire déposent leurs prospects dans un formulaire Wodz.

Aller plus loin 2 écrans ≈ 2 min à jour le 26/10/2026

Un autre outil inscrit vos prospects dans Wodz avec une clé d'API. Chaque prospect arrive dans le formulaire choisi, comme s'il l'avait rempli : même suivi, mêmes relances.

La même clé sert à étiqueter vos contacts : voir Étiqueter des contacts depuis un autre outil.

Où : Menu › Paramètres › « API ».

Créer une clé

Tapez le nom de l'outil qui s'en servira, puis cliquez sur « Créer la clé ». Cliquez sur « Copier » et collez la clé tout de suite dans cet outil : elle ne s'affiche qu'une fois.

Cliquez ensuite sur « J'ai copié la clé ». Elle rejoint la liste, marquée « jamais utilisée » jusqu'au premier appel de l'outil.

La clé s'affiche une seule fois. Wodz n'en garde qu'une empreinte et ne pourra plus vous la montrer.

Prenez une clé par outil. Le jour où un prestataire s'en va, vous révoquez la sienne sans couper les autres.

Point d’attention. La clé ne doit jamais apparaître dans le code d'une page de votre site : n'importe quel visiteur pourrait la lire et inscrire des inconnus chez vous. Pour un formulaire sur votre site, prenez le formulaire Wodz à intégrer.

Choisir le formulaire qui reçoit les prospects

Le formulaire sert de compartiment : ses chiffres (prospects, séances d'essai, inscrits) sont ceux de la source. Créez-en un par campagne ou par outil.

Choisissez-le dans « Formulaire qui reçoit les prospects », sous « Brancher un outil ». Son identifiant s'affiche à côté : c'est la valeur du champ form. L'exemple d'appel se met à jour avec lui.

Depuis la page d'un formulaire, « Brancher un outil » ouvre cette page avec le formulaire déjà choisi.

L'identifiant et l'exemple suivent le formulaire choisi. Copiez l'exemple, le champ form est déjà rempli.

Configurer l'appel

Réglage	Valeur
Méthode	`POST`
Adresse	celle affichée sous « Adresse »
En-têtes	`Authorization: Bearer <votre clé>` et `Content-Type: application/json`
Corps	du JSON, avec les champs ci-dessous

Champ	Ce qu'il porte
`form`	Obligatoire. L'identifiant du formulaire.
`email`	Obligatoire. Un e-mail déjà connu ne crée pas de doublon : le prospect revient dans votre suivi.
`firstname`	Obligatoire, sauf si `full_name` est donné.
`lastname`	Facultatif.
`full_name`	Le nom complet d'un formulaire Meta, découpé au premier espace quand `firstname` manque.
`phone`	Facultatif. Absent, le téléphone d'un prospect connu est conservé.
`comment`	Facultatif. Les réponses aux questions libres, recopiées dans l'historique de la fiche.
`dry_run`	`true` pour un essai.

{
  "form": "identifiant-du-formulaire",
  "firstname": "Camille",
  "lastname": "Martin",
  "email": "camille.martin@example.com",
  "phone": "+33612345678",
  "comment": "Objectif : reprendre le sport"
}

Faire un essai

Ajoutez "dry_run": true au corps. Wodz vérifie la clé, le formulaire et les champs, puis répond sans inscrire personne.

La réponse reprend le prénom, le nom et l'e-mail tels que Wodz les a compris. Vous voyez tout de suite si les champs de votre outil sont bien rangés.

Lire la réponse

Code HTTP	Valeur	Ce qui s'est passé
201	`created`	Nouveau prospect.
200	`existing`	E-mail déjà connu : le prospect revient dans votre suivi.
200	`dry_run`	Essai, rien n'est inscrit.
401	`missing_key`, `invalid_key`	Clé absente, inconnue ou révoquée.
404	`form_not_found`	Aucun formulaire de ce nom dans votre salle.
422	`form_archived`	Le formulaire est archivé.
422	`form_not_supported`	Formulaire d'un partenaire d'abonnements (Wellpass, ClassPass) : il ne reçoit pas de prospects.
422	`validation`	Un champ manque ou est invalide : `error.fields` le nomme.
429	`rate_limited`	Plus de 120 appels en une minute, ou 2 000 en un jour, avec cette clé. Réessayez après le délai de `Retry-After`.
429	`too_many_failed_attempts`	Trop d'appels refusés depuis la même adresse.

La valeur est dans result pour un appel réussi, dans error.code pour une erreur. error.message l'explique en français.

Vérifier que l'outil appelle bien

Sur la ligne de la clé, « Dernier appel » dit quand l'outil s'en est servi, et le compteur combien de prospects nouveaux elle a inscrits. Une clé « jamais utilisée » n'a reçu aucun appel : l'outil n'envoie rien, ou pas avec cette clé.

Une clé perdue ne se retrouve pas. Cliquez sur « Révoquer », puis créez-en une nouvelle.

Cet article a-t-il répondu à votre question ?

Poser ma question au support