Codes d'erreur
Chaque code d'erreur de l'API, ce qu'il veut dire et quoi faire.
Chaque erreur est un problème RFC 9457 (application/problem+json) : type (l'adresse de cette page), title, status, detail (en français ou en anglais selon Accept-Language), un code STABLE et le request_id. Un programme branche sur code, jamais sur le texte.
account_required
HTTP 400 · Account required
Une clé d'agence doit préciser le compte visé avec l'en-tête Lidmeo-Account (voir GET /v1/accounts).
Que faire. Une clé ou une connexion d'agence nomme le compte visé : ajoutez l'en-tête Lidmeo-Account: acct_….
invalid_api_version
HTTP 400 · Invalid API version
L'en-tête Lidmeo-Version ne désigne pas une version connue.
Que faire. Envoyez une version connue dans Lidmeo-Version (ou aucune : la dernière).
invalid_json
HTTP 400 · Invalid JSON
Le corps de la requête n'est pas du JSON valide.
Que faire. Envoyez un corps JSON valide, avec Content-Type: application/json.
invalid_request
HTTP 400 · Invalid request
La requête n'est pas valide. Le détail par champ est dans « errors ».
Que faire. Corrigez la requête : errors dit quel champ et pourquoi (unknown_parameter : un paramètre que la route ne connaît pas, jamais ignoré).
test_mode_only
HTTP 400 · Test mode only
Cette action n'existe qu'en mode test (clé lid_test_…).
Que faire. Cette opération n'existe qu'en mode test : utilisez une clé lid_test_….
api_key_expired
HTTP 401 · API key expired
Cette clé d'API a expiré. Créez-en une nouvelle depuis Intégrations.
Que faire. Vérifiez la clé ou le jeton (en-tête Authorization: Bearer …).
api_key_revoked
HTTP 401 · API key revoked
Cette clé d'API a été révoquée. Créez-en une nouvelle depuis Intégrations.
Que faire. Vérifiez la clé ou le jeton (en-tête Authorization: Bearer …).
invalid_api_key
HTTP 401 · Invalid API key
Cette clé d'API n'existe pas ou a été mal recopiée.
Que faire. Vérifiez la clé ou le jeton (en-tête Authorization: Bearer …).
invalid_token
HTTP 401 · Invalid token
Ce jeton n'est plus valable. Reconnectez l'application.
Que faire. Vérifiez la clé ou le jeton (en-tête Authorization: Bearer …).
unauthorized
HTTP 401 · Unauthorized
Authentification requise : envoyez une clé d'API ou un jeton dans l'en-tête Authorization (Bearer).
Que faire. Vérifiez la clé ou le jeton (en-tête Authorization: Bearer …).
insufficient_credits
HTTP 402 · Insufficient credits
Le solde de crédits ne suffit pas : rien n'a été lancé.
Que faire. Le solde ne couvre pas la recherche (cost, balance, count) : rechargez vos crédits dans Lidmeo, puis relancez.
account_not_found
HTTP 403 · Account not accessible
Ce compte n'existe pas ou n'appartient pas à votre agence.
Que faire. Le compte nommé (Lidmeo-Account) n'est pas à cette clé ou à cette agence : vérifiez son identifiant.
forbidden
HTTP 403 · Forbidden
Cette action n'est pas permise sur ce compte.
Que faire. Cette action n'est pas permise à cette clé ou à cette personne (par exemple la vue d'un compte en lecture seule).
insufficient_scope
HTTP 403 · Insufficient scope
Cette clé ou cette connexion n'a pas le droit nécessaire.
Que faire. Donnez à la clé ou à la connexion le droit qui manque (champ required_scopes).
ip_not_allowed
HTTP 403 · IP address not allowed
Cette clé n'accepte pas les requêtes venant de cette adresse IP.
Que faire. Appelez depuis une adresse IP autorisée sur la clé, ou élargissez la liste dans Lidmeo.
subscription_inactive
HTTP 403 · Subscription inactive
L'abonnement de ce compte n'est plus actif.
Que faire. L'abonnement du compte n'est plus actif : rien ne se lit ni ne s'écrit avant sa reprise.
not_found
HTTP 404 · Not found
Cet objet n'existe pas sur ce compte.
Que faire. Vérifiez l'identifiant : il n'existe pas sur ce compte (ou dans ce mode, réel ou test).
method_not_allowed
HTTP 405 · Method not allowed
Cette méthode HTTP n'existe pas sur cette ressource.
Que faire. La route existe avec une autre méthode : l'en-tête Allow la donne.
already_connected
HTTP 409 · Already connected
Cette personne est déjà dans vos relations : aucune invitation ne part.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
already_invited
HTTP 409 · Already invited
Une invitation est déjà partie vers cette personne.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
already_scheduled
HTTP 409 · Already scheduled
Ce message est déjà programmé : il partira seul.
Que faire. Elle part déjà (demandée à requested_at) : ne la redemandez pas.
already_sent
HTTP 409 · Already sent
Ce message est déjà parti.
Que faire. C'est déjà parti : relisez la fiche ou la conversation.
campaign_limit_reached
HTTP 409 · Campaign limit reached
L'offre du compte ne permet pas une campagne active de plus : mettez-en une en pause, ou changez d'offre.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
conflict
HTTP 409 · Conflict
L'état de l'objet ne permet pas cette action.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
daily_cap_reached
HTTP 409 · Daily cap reached
La limite d'envois du jour est atteinte : rien n'est parti.
Que faire. La limite du jour est atteinte : rien n'est parti. Réessayez à next_slot_at (la limite est dite dans cap quand elle est propre à l'API).
delivery_in_progress
HTTP 409 · Delivery in progress
Cette livraison est en train de partir. Réessayez dans un instant.
Que faire. Cette livraison part en ce moment : relisez-la dans un instant.
duplicate
HTTP 409 · Duplicate
Cette personne est déjà contactée par une autre fiche du compte : celle-ci est écartée.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
email_conversation
HTTP 409 · E-mail conversation
Cette conversation se tient par e-mail : l'envoi d'e-mails par l'API n'est pas encore ouvert.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
external_id_in_use
HTTP 409 · External id in use
Cet identifiant externe est déjà relié à une autre fiche du compte.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
followup_blocked
HTTP 409 · Follow-up not possible
La relance n'est plus possible pour ce contact (la raison est dans « blocker »).
Que faire. La relance n'est plus possible (blocker dit pourquoi : réponse, étape, déjà relancé…) : relisez la fiche.
idempotency_key_in_use
HTTP 409 · Idempotency key in use
Une requête avec cette Idempotency-Key est encore en cours. Réessayez dans un instant.
Que faire. La première requête de cette clé tourne encore : attendez sa réponse, puis rejouez avec la même clé.
import_in_progress
HTTP 409 · Import in progress
Un import est déjà en cours sur ce compte. Réessayez dans un instant.
Que faire. Un autre import tourne sur ce compte : réessayez dans quelques secondes (la même clé d'idempotence reste valable).
limit_reached
HTTP 409 · Limit reached
Le compte a atteint le nombre maximal pour cet objet.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
linkedin_disconnected
HTTP 409 · LinkedIn disconnected
Aucun compte LinkedIn n'est connecté : rien ne peut partir.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
name_taken
HTTP 409 · Name taken
Ce nom est déjà pris sur ce compte.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
no_conversation
HTTP 409 · No conversation
Aucune conversation LinkedIn avec ce contact dans Lidmeo : le message part depuis LinkedIn.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
no_message
HTTP 409 · No message
Le premier message n'est pas encore rédigé : passez le texte.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
not_approvable
HTTP 409 · Not approvable
Cette fiche n'attend pas cette validation (rien en attente, campagne en envoi automatique, ou déjà validée pour le prochain créneau).
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
not_removable
HTTP 409 · Not removable
Seul un prospect pas encore contacté se retire de la file (en file, à valider, connexion acceptée sans message), ou un lead suivi ; jamais pendant son envoi.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
not_replied
HTTP 409 · Not a reply
Ce contact ne vous a pas répondu : une réponse ne s'écrit qu'à quelqu'un qui a écrit. Envoyez une relance (kind « follow_up »), avec ses règles.
Que faire. Ce contact n'a pas répondu : envoyez une relance (kind: "follow_up"), avec ses règles.
not_sendable
HTTP 409 · Not sendable
Cette fiche ne peut pas recevoir cet envoi : elle est écartée (la raison est dans « reason »).
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
profile_unknown
HTTP 409 · Profile unknown
Le profil LinkedIn de ce prospect est inconnu : validez-le depuis Lidmeo.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
prospecting_not_configured
HTTP 409 · Prospecting not configured
La prospection de ce compte n'est pas configurée : rien ne peut partir.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
send_in_progress
HTTP 409 · Send in progress
Un autre envoi de ce compte est en cours : rien n'est parti. Réessayez dans un instant.
Que faire. Un autre envoi de ce compte part en ce moment : rien n'est parti, réessayez dans un instant (la même clé reste valable).
sends_paused
HTTP 409 · Sends paused
Les envois du compte LinkedIn sont en pause pour le protéger : rien n'est parti.
Que faire. Lidmeo a mis les envois en pause pour protéger le compte LinkedIn : rien n'est parti, reprise à resumes_at.
stage_not_available
HTTP 409 · Stage not available
Une étape ne se pose que sur un contact à qui un premier message est parti, ou sur un lead suivi.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
suppressed
HTTP 409 · Do not contact
Ce prospect est dans votre liste « Ne plus contacter » : rien ne part, la fiche est écartée.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
switch_offer_pending
HTTP 409 · Switch offer pending
Cette campagne a une proposition de passage à la nouvelle recherche en attente : décidez-la dans Lidmeo avant de changer son ciblage.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
test_reset_in_progress
HTTP 409 · Test reset in progress
Le compte de test est en train d'être rempli : réessayez dans un instant.
Que faire. La remise à zéro du compte de test tourne : réessayez dans un instant.
webhook_endpoint_disabled
HTTP 409 · Webhook endpoint disabled
Cette adresse de réception est désactivée : réactivez-la (status: enabled) avant d'y envoyer quoi que ce soit.
Que faire. L'état actuel ne le permet pas : relisez l'objet, puis décidez. Ne reprenez pas en boucle.
idempotency_key_mismatch
HTTP 422 · Idempotency key reused
Cette Idempotency-Key a déjà servi pour une requête différente.
Que faire. Cette clé a servi à une AUTRE requête : prenez une nouvelle Idempotency-Key pour une nouvelle opération.
rate_limited
HTTP 429 · Too many requests
Trop de requêtes. Réessayez après le délai indiqué par Retry-After.
Que faire. Attendez le délai de l'en-tête Retry-After (une seconde après une rafale), puis reprenez.
internal_error
HTTP 500 · Internal error
Une erreur inattendue s'est produite. L'identifiant de requête permet au support de la retrouver.
Que faire. Rien que vous puissiez corriger : réessayez plus tard, avec la même Idempotency-Key ; si l'erreur dure, donnez le request_id au support.
send_failed
HTTP 502 · Send failed
LinkedIn n'a pas accepté l'envoi. Relisez la fiche avant toute nouvelle tentative, jamais en boucle : la même Idempotency-Key rejoue cette réponse sans rien renvoyer.
Que faire. Ne reprenez pas automatiquement (les SDK ne le font pas) : relisez la fiche, vérifiez le compte LinkedIn dans Lidmeo, puis réessayez plus tard, une fois, avec une nouvelle Idempotency-Key.
sends_disabled
HTTP 503 · Sends disabled
Les envois par l'API sont momentanément coupés : rien n'est parti. Réessayez plus tard.
Que faire. Les envois par l'API sont coupés par Lidmeo pour le moment : ne reprenez pas en boucle, les lectures restent ouvertes.
service_unavailable
HTTP 503 · Service unavailable
Ce service est momentanément indisponible. Réessayez dans quelques minutes.
Que faire. Une lecture a échoué de notre côté : réessayez avec un délai croissant. Après une écriture, relisez l'objet avant de reprendre sans Idempotency-Key (applied dit ce qui a été fait).