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

  1. Dans le CRM : Réglages → API et webhooks (administrateur, offre comprenant l'API).
  2. Créez une clé, en lecture seule ou en lecture et écriture. Copiez-la : elle n'est affichée qu'une fois.
  3. 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.

/api/v1

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=1 pour 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 dans GET /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

AdresseObjetFiltresChamps modifiables
/personnesContactsemail, entreprise_id, proprietaire_idprenom, nom, email, telephone, entreprise_id, proprietaire_id, particulier, adresse, code_postal, ville, pays, etiquettes, champs
/entreprisesEntreprisessiren, proprietaire_idnom, telephone, email, site_web, adresse, code_postal, ville, pays, siren, proprietaire_id, etiquettes, champs
/leadsLeadsstatut, personne_id, entreprise_id, proprietaire_id, origine_idtitre, personne_id, entreprise_id, proprietaire_id, origine_id, valeur, statut (nouveau, en_cours, archive), etiquettes, champs
/affairesAffairesstatut, pipeline_id, etape_id, personne_id, entreprise_id, proprietaire_id, origine_id, lead_idtitre, 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
/notesNotes et historiquetype, personne_id, entreprise_id, lead_id, affaire_id, auteur_idtype (note, appel, email, rendez_vous), contenu, epingle, et une fiche : personne_id, entreprise_id, lead_id ou affaire_id
/tachesTâchestype, type_perso, priorite, assigne_a, personne_id, entreprise_id, lead_id, affaire_id, dossier_idtype, 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-vousRendez-vousstatut, membre_id, personne_id, lead_id, affaire_idlecture seule
/devisDevisstatut, affaire_idlecture seule
/dossiersDossiers de suivi après-ventestatut, modele_id, etape_id, affaire_id, personne_id, entreprise_id, responsable_idcré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-suiviModèles de suivi et leurs étapesactif, par_defautlecture seule
/pipelinesPipelines et étapesactiflecture seule
/membresUtilisateursactif, role, emaillecture seule
/originesOriginesactiflecture seule
/motifs-perteMotifs de perteactiflecture seule
/etiquettesÉtiquettesactiflecture seule
/champsChamps personnaliséscible, actiflecture seule
/relancesRelances automatiques et leurs étapesactiflecture seule ; inscrire un contact : POST /relances/id/inscrire
/inscriptions-relancesInscriptions aux relancesstatut, sequence_id, personne_id, lead_id, affaire_id, membre_idlecture 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.

Retour à l'accueil