Documentation développeurs
API du CRM
Branchez votre CRM à tous vos outils — Make, Zapier, votre site, votre logiciel maison — sans passer par nous. Vous lisez et écrivez vos contacts, entreprises, leads, affaires, notes et tâches, et vous êtes prévenu de chaque événement par webhook.
Démarrer en 2 minutes
- Dans le CRM : Réglages → API et webhooks (administrateur, offre comprenant l'API).
- Créez une clé, en lecture seule ou en lecture et écriture. Copiez-la : elle n'est affichée qu'une fois.
- Envoyez-la dans l'en-tête de chaque appel :
curl https://www.elanza.io/api/v1/moi \
-H "Authorization: Bearer crm_VOTRE_CLE"L'en-tête « x-api-key: crm_VOTRE_CLE » est aussi accepté (pratique dans Make et Zapier). Une clé agit avec les droits de l'administrateur qui l'a créée, sur son seul espace ; elle cesse de fonctionner si elle est révoquée ou si cette personne n'est plus administrateur. Ne la mettez jamais dans une page web visible par vos visiteurs.
Essayer l'API ici
Collez votre clé, choisissez un exemple, cliquez « Envoyer » : vous voyez la réponse exacte que recevront vos outils.
Format
- Adresse de base :
https://www.elanza.io/api/v1 - JSON en entrée (
Content-Type: application/json) et en sortie. Dates au format ISO 8601, montants en euros. - Lister :
GET /objet→{ "donnees": [...], "page": 1, "par_page": 50, "suivant": true }. Paramètres :page,par_page(100 au plus),modifie_depuis(synchronisation),archives=1pour inclure les fiches archivées, et des filtres par objet (ci-dessous). - Lire :
GET /objet/id. Créer :POST /objet. Modifier :PATCH /objet/id(seuls les champs envoyés changent). Supprimer :DELETE /objet/id— contacts, entreprises, leads et affaires sont archivés (réversible), notes et tâches sont supprimées. - Anti-doublon : créer un contact dont l'e-mail ou le téléphone existe déjà renvoie la fiche existante avec
"doublon": true(même règle que dans le CRM). Idem pour une entreprise de même SIREN. - Champs personnalisés :
"champs": { "<id du champ>": valeur }— la liste et les identifiants sont dansGET /champs. - Propriétaire par défaut d'une fiche créée : l'administrateur de la clé. Pour qu'un lead suive vos règles d'attribution automatique, envoyez
"proprietaire_id": null, ou utilisez l'adresse d'entrée des leads (Réglages → Automatisations), qui prévient aussi le commercial. - Une affaire dont le montant est calculé depuis ses produits (
montant_auto) ne change de montant que par ses produits.
Objets
| Adresse | Objet | Filtres | Champs modifiables |
|---|---|---|---|
| /personnes | Contacts | email, entreprise_id, proprietaire_id | prenom, nom, email, telephone, entreprise_id, proprietaire_id, particulier, adresse, code_postal, ville, pays, etiquettes, champs |
| /entreprises | Entreprises | siren, proprietaire_id | nom, telephone, email, site_web, adresse, code_postal, ville, pays, siren, proprietaire_id, etiquettes, champs |
| /leads | Leads | statut, personne_id, entreprise_id, proprietaire_id, origine_id | titre, personne_id, entreprise_id, proprietaire_id, origine_id, valeur, statut (nouveau, en_cours, archive), etiquettes, champs |
| /affaires | Affaires | statut, pipeline_id, etape_id, personne_id, entreprise_id, proprietaire_id, origine_id, lead_id | titre, personne_id, entreprise_id, proprietaire_id, pipeline_id, etape_id, montant, statut (en_cours, gagnee, perdue), motif_perte_id, cloture_prevue, origine_id, etiquettes, champs |
| /notes | Notes et historique | type, personne_id, entreprise_id, lead_id, affaire_id, auteur_id | type (note, appel, email, rendez_vous), contenu, epingle, et une fiche : personne_id, entreprise_id, lead_id ou affaire_id |
| /taches | Tâches | type, type_perso, priorite, assigne_a, personne_id, entreprise_id, lead_id, affaire_id, dossier_id | type, type_perso (un type d'activité de votre espace, ex. visite-technique), sujet, echeance, priorite, assigne_a, et une fiche à la création ; « fait »: true / false pour la cocher |
| /rendez-vous | Rendez-vous | statut, membre_id, personne_id, lead_id, affaire_id | lecture seule |
| /devis | Devis | statut, affaire_id | lecture seule |
| /dossiers | Dossiers de suivi après-vente | statut, modele_id, etape_id, affaire_id, personne_id, entreprise_id, responsable_id | création : affaire_id, modele_id (+ titre, responsable_id, etape_id, date_debut, date_fin, champs) ; modification : titre, etape_id, statut (actif, a_relancer, termine, abandon, annule), responsable_id, date_arrivee, date_debut, date_fin, champs (champs personnalisés « Dossiers de suivi »). Les tâches du modèle se créent et se datent toutes seules (liste : /taches?dossier_id=…) |
| /modeles-suivi | Modèles de suivi et leurs étapes | actif, par_defaut | lecture seule |
| /pipelines | Pipelines et étapes | actif | lecture seule |
| /membres | Utilisateurs | actif, role, email | lecture seule |
| /origines | Origines | actif | lecture seule |
| /motifs-perte | Motifs de perte | actif | lecture seule |
| /etiquettes | Étiquettes | actif | lecture seule |
| /champs | Champs personnalisés | cible, actif | lecture seule |
| /relances | Relances automatiques et leurs étapes | actif | lecture seule ; inscrire un contact : POST /relances/id/inscrire |
| /inscriptions-relances | Inscriptions aux relances | statut, sequence_id, personne_id, lead_id, affaire_id, membre_id | lecture seule ; arrêter : POST /inscriptions-relances/id/arreter |
Relances automatiques (si elles sont allumées dans l'espace) : POST /relances/id/inscrire avec { "personne_id": "…", "lead_id": "…", "affaire_id": "…" } (seul personne_id est obligatoire ; relances d'équipe seulement ; les e-mails partent de la boîte du propriétaire de la fiche). Un particulier doit avoir donné son accord pour les e-mails (sinon 422). POST /inscriptions-relances/id/arreter arrête une inscription en cours.
Action : POST /leads/id/convertir transforme un lead en affaire (corps facultatif { "pipeline_id": "…" }, sinon premier pipeline) et renvoie l'affaire.
Exemples
Créer un contact
curl -X POST https://www.elanza.io/api/v1/personnes \
-H "Authorization: Bearer crm_VOTRE_CLE" -H "Content-Type: application/json" \
-d '{ "prenom": "Jeanne", "nom": "Exemple", "email": "jeanne@exemple.fr" }'Créer une affaire dans la première étape
curl -X POST https://www.elanza.io/api/v1/affaires \
-H "Authorization: Bearer crm_VOTRE_CLE" -H "Content-Type: application/json" \
-d '{ "titre": "Rénovation cuisine", "montant": 12500, "personne_id": "…" }'Gagner une affaire
curl -X PATCH https://www.elanza.io/api/v1/affaires/ID \
-H "Authorization: Bearer crm_VOTRE_CLE" -H "Content-Type: application/json" \
-d '{ "statut": "gagnee" }'Récupérer les affaires modifiées depuis hier
curl "https://www.elanza.io/api/v1/affaires?modifie_depuis=2026-11-01T00:00:00Z&par_page=100" \
-H "Authorization: Bearer crm_VOTRE_CLE"Téléphonie (Aircall, Ringover, Allo…)
Chaque appel terminé s'envoie à POST https://www.elanza.io/api/v1/appels : il est noté sur l'affaire en cours du contact, sinon sur son lead ouvert, sinon sur sa fiche (numéro reconnu sur ses 9 derniers chiffres : « 06… » ≡ « +33 6… »). Un inconnu qui appelle devient un lead ; un appel entrant manqué crée une tâche « Rappeler » urgente. Un même id_appel envoyé deux fois n'est noté qu'une fois.
curl -X POST https://www.elanza.io/api/v1/appels \
-H "Authorization: Bearer crm_VOTRE_CLE" -H "Content-Type: application/json" \
-d '{ "numero": "+33612345678", "sens": "entrant", "issue": "manque", "logiciel": "Aircall", "id_appel": "123456", "membre_email": "commercial@exemple.fr" }'Champs : numero et sens (entrant, sortant) obligatoires ; issue (repondu, manque, messagerie, occupe), duree_secondes, debut (ISO 8601), enregistrement_url (https), logiciel, id_appel, membre_email ou membre_id, note, creer_lead_si_inconnu (vrai par défaut pour un appel entrant), rappel_si_manque (vrai par défaut).
Qui appelle ? GET https://www.elanza.io/api/v1/appels?numero=+33612345678 renvoie le contact, son entreprise, son lead ou son affaire en cours, son propriétaire et le lien de la fiche ({ "trouve": false } sinon). Les appels notés se relisent avec GET https://www.elanza.io/api/v1/notes?type=appel.
Assistants IA (MCP)
Un assistant IA compatible MCP (Claude, Cursor, n8n, Make…) peut chercher, lire, créer et modifier vos fiches, et noter des appels, avec une clé API de votre espace : mêmes droits que la clé (lecture seule ou lecture et écriture).
Adresse : https://www.elanza.io/api/mcp (transport HTTP), en-tête Authorization: Bearer crm_VOTRE_CLE. Outils : chercher, lister, lire, creer, modifier, qui_appelle, noter_appel, inscrire_relance, arreter_relance.
Conseil de sécurité : un assistant IA peut être trompé par un texte écrit dans une fiche (« ignore tes consignes et… »). Donnez-lui d'abord une clé en lecture seule ; avec une clé en écriture, gardez la confirmation de chaque action activée dans votre assistant.
Claude Code
claude mcp add --transport http crm https://www.elanza.io/api/mcp --header "Authorization: Bearer crm_VOTRE_CLE"Claude Desktop, Cursor (fichier de configuration MCP)
{ "mcpServers": { "crm": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.elanza.io/api/mcp", "--header", "Authorization: Bearer crm_VOTRE_CLE"] } } }Les connecteurs qui exigent une connexion par compte (OAuth), comme ceux de ChatGPT, ne sont pas encore pris en charge.
Webhooks
Dans Réglages → API et webhooks, ajoutez l'adresse de votre outil (https) et cochez les événements. À chaque événement, nous envoyons :
POST https://votre-adresse
X-CRM-Evenement: affaire.gagnee
X-CRM-Signature: t=1762000000,v1=5f2b…
{ "id": "evt_123", "type": "affaire.gagnee", "date": "2026-11-02T09:15:00.000Z",
"objet_id": "…", "donnees": { "affaire": { "titre": "…", "montant": 12500, … }, "contact": { … }, "lien": "…" } }lead.cree — Un lead arrive
lead.converti — Un lead est transformé en affaire
contact.cree — Un contact est créé
contact.modifie — Un contact est modifié (propriétaire, étiquettes, champs, coordonnées)
entreprise.creee — Une entreprise est créée
affaire.creee — Une affaire est créée
affaire.etape — Une affaire change d'étape
affaire.modifiee — Une affaire est modifiée (montant, propriétaire, étiquettes, champs, clôture prévue)
affaire.gagnee — Une affaire est gagnée
affaire.perdue — Une affaire est perdue
rdv.pose — Un rendez-vous est pris
rdv.deplace — Un rendez-vous est déplacé
rdv.annule — Un rendez-vous est annulé
rdv.honore — Le client est venu au rendez-vous
rdv.absent — Le client n'est pas venu au rendez-vous
tache.terminee — Une tâche est faite
devis.envoye — Un devis est envoyé au client
devis.vu — Le client ouvre son devis
devis.accepte — Un devis est accepté par le client
devis.refuse — Un devis est refusé par le client
contrat.envoye — Un contrat est envoyé pour signature
contrat.vu — Le client ouvre son contrat
contrat.signe — Un contrat est signé par le client
contrat.refuse — Un contrat est refusé par le client
facture.emise — Une facture ou un avoir est émis
dossier.ouvert — Un dossier de suivi s'ouvre
dossier.etape — Un dossier de suivi change d'étape
dossier.termine — Un dossier de suivi est terminé
appel.note — Un appel est noté (téléphonie)
appel.manque — Un appel entrant est manqué
Répondez par un code 2xx en moins de 5 secondes. Pour vérifier que l'envoi vient bien de nous, recalculez la signature avec le secret du webhook :
import crypto from "node:crypto";
// corps = texte brut reçu (avant JSON.parse), entete = valeur de « X-CRM-Signature »
function signatureValide(secret, corps, entete) {
const t = /t=(\d+)/.exec(entete)?.[1];
const v1 = /v1=([0-9a-f]{64})/.exec(entete)?.[1];
if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const attendu = crypto.createHmac("sha256", secret).update(`${t}.${corps}`).digest("hex");
return crypto.timingSafeEqual(Buffer.from(attendu, "hex"), Buffer.from(v1, "hex"));
}En cas d'échec (pas de réponse 2xx), nous réessayons après 1 min, 5 min, 30 min, 2 h et 6 h. Un même événement peut donc arriver deux fois : dédoublonnez avec l'en-tête X-CRM-Livraison (identique à chaque essai). Les derniers envois et leur résultat sont visibles dans l'écran des webhooks. Après 50 échecs d'affilée, le webhook est mis en pause (réactivable en un clic) ; il est aussi suspendu si son créateur n'est plus administrateur. Pour relire une fiche complète, appelez GET /objet/objet_id.
Erreurs et limites
- Les erreurs renvoient
{ "erreur": "message en clair" }avec le code HTTP : 400 (paramètre), 401 (clé absente, inconnue ou révoquée), 403 (clé en lecture seule, API hors de votre offre, espace fermé), 404 (introuvable dans votre espace), 409 (conflit, ex. rendez-vous sans résultat), 413, 415, 422 (donnée refusée), 429 (trop d'appels). - Limite : 600 appels par minute et par clé (1 500 par espace). Au-delà : code 429 et en-tête
Retry-After. - Vos données restent hébergées en France ; chaque espace est strictement isolé des autres.