L'API Lidmeo
Une API REST pour vos prospects, vos conversations, vos campagnes et votre CRM : conventions, ressources, contrat OpenAPI.
https://api.lidmeo.com/v1L'API fait ce que fait l'écran de Lidmeo, et tout ce que fait l'assistant IA connecté à Lidmeo, par les mêmes fonctions : lire votre CRM, le ranger, trouver et ajouter des prospects, créer, régler et lancer des campagnes, valider des invitations, envoyer des messages, suivre ce qui se passe. Les limites d'envoi, les horaires et « Ne plus contacter » s'y appliquent à l'identique.
Restent dans Lidmeo, comme pour l'assistant : connecter LinkedIn, une boîte e-mail ou WhatsApp (l'API en donne l'état et le lien de la page, GET /v1/settings/connections), l'abonnement et l'achat de crédits, l'offre Team, le parrainage et les suggestions de réponse de la messagerie.
Conventions
- JSON en UTF-8, noms de champs en anglais
snake_case. - Dates en ISO 8601, en UTC (
2026-10-01T08:30:00Z). Un jour seul (2026-10-02), commereminder_on, est un jour de Paris ; dansupdated_since, il commence à minuit, heure de Paris. - Identifiants opaques et préfixés :
acct_(compte),org_(agence),pros_(prospect),cmp_(campagne),conv_(conversation),msg_(message),stg_(étape),lst_(liste),note_,imp_(import),job_(recherche de coordonnées),sup_(« ne plus contacter »),evt_(événement),whe_(adresse de réception),whd_(livraison),key_(clé d'API),app_(application),grt_(connexion OAuth) ; pour Copilote,rep_(réponse de l'agent),gol_(objectif),res_(ressource),kno_(source de connaissances),mtg_(rendez-vous),cnv_(conversion). Ne les fabriquez pas, ne les découpez pas : relisez-les tels quels. - Chaque objet porte
object(son type) ; ceux du compte (prospects, conversations, messages, campagnes, notes, événements, adresses de réception…) portent aussilivemode(falseen mode test). - Chaque réponse porte l'en-tête
Request-Id: donnez-le au support si quelque chose vous étonne. Vous pouvez aussi envoyer le vôtre : il est repris s'il fait de 8 à 64 caractères (lettres, chiffres,.,_et-), sinon Lidmeo en crée un. - Un paramètre inconnu n'est jamais ignoré : il répond
400 invalid_request, avec danserrorsle codeunknown_parameteret le champquery.<nom>. - Les erreurs sont des problèmes RFC 9457 avec un
codestable : voir les erreurs. - Les listes se lisent par pages, avec un curseur : voir la pagination.
- Les écritures acceptent une
Idempotency-Key: voir l'idempotence.
Les envois ne promettent jamais l'instant
Une action qui fait partir quelque chose (valider une invitation, un premier message, répondre, relancer) répond 202 et dit ce qui s'est vraiment passé :
status | Ce que cela veut dire |
|---|---|
sent | C'est parti. |
scheduled | Cela partira au plus tôt à scheduled_at ; cause dit pourquoi : window (hors de vos horaires), cap (limite du jour atteinte), paused (envois en pause pour protéger le compte). La file fait partir un envoi à la fois, dans vos limites : avec plusieurs envois programmés, la plupart partent plus tard. Relisez le prospect pour savoir quand il est parti. |
already_sent | C'était déjà parti. |
already_connected | Pas besoin d'invitation : la personne est déjà une relation. |
Sinon, un refus qui dit pourquoi : suppressed (« ne plus contacter »), daily_cap_reached, linkedin_disconnected, not_approvable… Rien n'est jamais présenté comme parti s'il ne l'est pas.
- Un envoi à la fois par compte : un second, pendant ce temps, répond
409 send_in_progress; réessayez dans un instant. - Le texte est le vôtre, et final : vide, ou s'il garde une variable de gabarit (
{{prenom}},[Prénom]…), il répond400 invalid_request. Une relance tient en 2000 caractères au plus ; les autres textes, en 4000. - Une réponse (
kind: "reply") ne part que vers un contact qui a répondu (sonreplied_at, ou une réponse déjà visible dans la conversation), sinon409 not_replied. Aveckind: "auto", c'est une réponse quand Lidmeo voit que le contact a répondu, une relance sinon. Jamais vers « Ne plus contacter », et au plus 100 par jour et par compte par l'API : au-delà,409 daily_cap_reached, aveccapetnext_slot_at. - Des fichiers avec une réponse :
attachments, jusqu'à 5 fichiers (filenameetcontent_base64, le fichier encodé en base64 sans préfixedata:), 3 Mo au plus pour l'ensemble une fois décodé. Images JPG, PNG ou GIF, PDF, Word, Excel, PowerPoint, TXT, CSV. Le type se lit dans le contenu, jamais dans le nom seul : un fichier refusé répond400 invalid_request, eterrorsle nomme (attachments[0]…). Une réponse seulement : avec une relance,400 invalid_request, l'erreur du champattachmentsétantreply_only. Rien ne part tant qu'un fichier est refusé ; la réponse202liste ceux qui sont partis.
Les actions en deux temps
Ce qui lance une campagne, y met des personnes, dépense des crédits, fait partir un message préparé ou supprime se fait en deux temps, comme dans l'assistant IA. La route qui prépare ne fait rien et rend un aperçu (step: "preview", preview_id, expires_at) ; POST /v1/previews/{id}/confirm fait exactement ce que l'aperçu a montré.
| Préparer | Ce qui se confirme |
|---|---|
POST /v1/campaigns/{id}/launch | le lancement d'une campagne qui n'a jamais tourné |
POST /v1/campaigns/{id}/add_prospects | des personnes mises dans la séquence d'une campagne |
POST /v1/people/add | des personnes trouvées par la Recherche, ajoutées (crédits) |
POST /v1/agents/{agent}/add_people | des personnes repérées par Lidmeo Agent, mises en campagne |
POST /v1/closer/replies/{id}/send | une réponse de l'agent Copilote, envoyée au prospect |
POST /v1/closer/meetings/{id}/cancel | l'annulation d'un rendez-vous (l'agenda relié prévient la personne) |
POST /v1/sequence_steps/approve | des relances et e-mails de séquence validés ou écartés |
POST /v1/prospects/{id}/drafts | un message : relance écrite par l'IA, réponse sur LinkedIn, par e-mail ou sur WhatsApp, premier message |
DELETE /v1/campaigns/{id} | la suppression d'une campagne |
- Un aperçu sert une fois, dans les 15 minutes, depuis la clé ou la connexion qui l'a préparé, dans le même mode. Expiré :
409 preview_expired; déjà confirmé :409 preview_already_used; préparé par une autre clé :404 not_found. - Rien d'autre ne se passe à la confirmation : son corps est vide. Une campagne modifiée depuis l'aperçu n'est pas lancée (
409 action_refused,reasonvautcampaign_changed). - Les droits sont ceux de la route qui a préparé (
sends:writepour lancer ou envoyer), et la confirmation compte dans le plafond d'actions d'envoi du jour de la clé (409 connection_cap_reached). - Un refus de ces routes qui n'a pas son propre code est
409 action_refused: le motif exact est dansreason, la marche à suivre dansdetail.
Une relance ou une réponse LinkedIn dont vous avez écrit le texte final part aussi en un seul appel : POST /v1/prospects/{id}/messages.
Les ressources
| Ressource | Ce qu'elle porte |
|---|---|
| Identité | GET /v1/me (qui appelle), GET /v1/accounts (les comptes couverts) |
| Compte | GET /v1/overview (la journée), GET /v1/activity, GET /v1/credits |
| Mise en route | la préparation de la première campagne d'un compte qui n'a pas encore activé son essai, question par question, comme les écrans d'entrée de Lidmeo (/v1/onboarding) |
| Prospects | la liste et ses vues, la recherche, l'ajout de prospects, l'étape, les rappels, les listes, les notes, l'historique, « Écarter », le lien avec vos outils, l'export Excel |
| Conversations | une par personne, LinkedIn, e-mail et WhatsApp réunis, leurs messages, la recherche dans les messages, le rappel, la température, « lu » |
| Campagnes | créer, cibler, écrire la séquence ou partir d'un modèle de Lidmeo (la galerie de « Voir les modèles », GET /v1/sequence_templates, et « Utiliser ce modèle », POST /v1/campaigns/{id}/sequence/apply_template), régler, lancer, y mettre ou en retirer des personnes, pause, reprise, relecture du site, suppression, entonnoir |
| Recherche | la base de contacts de Lidmeo : chercher de nouvelles personnes, les ajouter |
| Lidmeo Agent | les trois agents, leurs réglages, les personnes repérées |
| Copilote | l'agent qui répond à vos prospects (ses réglages, « Tester l'agent », ses connaissances), ses réponses à valider, le mode de chaque conversation, vos objectifs et leurs résultats, l'agenda ; avec l'offre Copilote (/v1/closer/…) |
| CRM | vos étapes, vos listes, « ne plus contacter » |
| Imports | des prospects en nombre, par la règle d'import de Lidmeo (« Importer des prospects ») |
| Envois | valider une invitation ou un premier message, envoyer une réponse ou une relance, préparer un message, valider les relances et e-mails de séquence, annuler une relance |
| Aperçus | confirmer une action en deux temps |
| Réglages | les comptes reliés, les réglages d'envoi, les e-mails de Lidmeo, la prospection et la répartition des nouveaux prospects |
| Support | vos échanges avec l'équipe Lidmeo |
| Aide | les articles d'aide de Lidmeo |
| Coordonnées | chercher l'e-mail ou le téléphone, avec vos crédits (jamais pour une personne « Ne plus contacter ») |
| Événements et webhooks | ce qui s'est passé, et les adresses qui le reçoivent |
| Mode test | remise à zéro, simulation d'une acceptation ou d'une réponse |
Chaque opération, ses paramètres et ses réponses : la référence complète, avec un essai en direct (utilisez une clé de test).
Le contrat
L'API est décrite par un document OpenAPI 3.1, généré depuis le code qui valide les requêtes : le contrat et le comportement ne peuvent pas diverger. Il déclare, pour chaque opération, chaque statut qu'elle peut répondre.
https://api.lidmeo.com/v1/openapi.jsonhttps://developers.lidmeo.com/openapi.json
Importez-le dans Postman, Insomnia ou votre générateur de client, ou utilisez nos SDK.