LidmeoDevelopers

L'API Lidmeo

Une API REST pour vos prospects, vos conversations, vos campagnes et votre CRM : conventions, ressources, contrat OpenAPI.

https://api.lidmeo.com/v1

L'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), comme reminder_on, est un jour de Paris ; dans updated_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 aussi livemode (false en 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 dans errors le code unknown_parameter et le champ query.<nom>.
  • Les erreurs sont des problèmes RFC 9457 avec un code stable : 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é :

statusCe que cela veut dire
sentC'est parti.
scheduledCela 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_sentC'était déjà parti.
already_connectedPas 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épond 400 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 (son replied_at, ou une réponse déjà visible dans la conversation), sinon 409 not_replied. Avec kind: "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, avec cap et next_slot_at.
  • Des fichiers avec une réponse : attachments, jusqu'à 5 fichiers (filename et content_base64, le fichier encodé en base64 sans préfixe data:), 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épond 400 invalid_request, et errors le nomme (attachments[0]…). Une réponse seulement : avec une relance, 400 invalid_request, l'erreur du champ attachments étant reply_only. Rien ne part tant qu'un fichier est refusé ; la réponse 202 liste 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éparerCe qui se confirme
POST /v1/campaigns/{id}/launchle lancement d'une campagne qui n'a jamais tourné
POST /v1/campaigns/{id}/add_prospectsdes personnes mises dans la séquence d'une campagne
POST /v1/people/adddes personnes trouvées par la Recherche, ajoutées (crédits)
POST /v1/agents/{agent}/add_peopledes personnes repérées par Lidmeo Agent, mises en campagne
POST /v1/closer/replies/{id}/sendune réponse de l'agent Copilote, envoyée au prospect
POST /v1/closer/meetings/{id}/cancell'annulation d'un rendez-vous (l'agenda relié prévient la personne)
POST /v1/sequence_steps/approvedes relances et e-mails de séquence validés ou écartés
POST /v1/prospects/{id}/draftsun 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, reason vaut campaign_changed).
  • Les droits sont ceux de la route qui a préparé (sends:write pour 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 dans reason, la marche à suivre dans detail.

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

RessourceCe qu'elle porte
IdentitéGET /v1/me (qui appelle), GET /v1/accounts (les comptes couverts)
CompteGET /v1/overview (la journée), GET /v1/activity, GET /v1/credits
Mise en routela 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)
Prospectsla 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
Conversationsune par personne, LinkedIn, e-mail et WhatsApp réunis, leurs messages, la recherche dans les messages, le rappel, la température, « lu »
Campagnescré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
Recherchela base de contacts de Lidmeo : chercher de nouvelles personnes, les ajouter
Lidmeo Agentles trois agents, leurs réglages, les personnes repérées
Copilotel'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/…)
CRMvos étapes, vos listes, « ne plus contacter »
Importsdes prospects en nombre, par la règle d'import de Lidmeo (« Importer des prospects »)
Envoisvalider 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çusconfirmer une action en deux temps
Réglagesles comptes reliés, les réglages d'envoi, les e-mails de Lidmeo, la prospection et la répartition des nouveaux prospects
Supportvos échanges avec l'équipe Lidmeo
Aideles articles d'aide de Lidmeo
Coordonnéeschercher l'e-mail ou le téléphone, avec vos crédits (jamais pour une personne « Ne plus contacter »)
Événements et webhooksce qui s'est passé, et les adresses qui le reçoivent
Mode testremise à 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.json
  • https://developers.lidmeo.com/openapi.json

Importez-le dans Postman, Insomnia ou votre générateur de client, ou utilisez nos SDK.

Sur cette page