Démarrer en 5 minutes

Créez une clé de testCopier le lien

Dans Lidmeo, ouvrez Intégrations, rubrique Clés d'API, puis Créer une clé. Donnez-lui un nom ; sous Données, choisissez Le compte de test (fictif, rien ne part vers LinkedIn) ; gardez les droits proposés, puis cliquez sur Créer la clé. La clé commence par lid_test_ : copiez-la tout de suite, elle ne sera plus jamais affichée.

export LIDMEO_API_KEY="lid_test_…"

Votre premier appelCopier le lien

curl https://api.lidmeo.com/v1/me \
  -H "Authorization: Bearer $LIDMEO_API_KEY"

La réponse dit qui appelle, sur quel compte, avec quels droits. livemode: false : vous êtes en mode test.

{
  "object": "me",
  "livemode": false,
  "credential": { "type": "api_key", "id": "key_1Q2w3E4r5T6y" },
  "account": "acct_1J4kQ8sLr2Xw",
  "organization": null,
  "scopes": ["account:read", "prospects:read", "contacts:read", "conversations:read", "prospects:write", "enrichment:write", "campaigns:write", "webhooks:manage"],
  "api_version": "2026-10-01",
  "plan": "pro"
}

Lisez un prospect invitéCopier le lien

curl "https://api.lidmeo.com/v1/prospects?pipeline_stage=invited&limit=1" \
  -H "Authorization: Bearer $LIDMEO_API_KEY"

Gardez son id (pros_…). Une liste répond toujours { "object": "list", "data": [...], "has_more": ..., "next_cursor": ... } : voir la pagination.

Simulez son acceptationCopier le lien

Les prospects d'exemple restent à leur étape ; seul ce que vous envoyez avance seul. Forcez donc l'acceptation :

curl https://api.lidmeo.com/v1/test/simulate \
  -H "Authorization: Bearer $LIDMEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prospect": "pros_…", "event": "invitation_accepted" }'

Lisez l'événementCopier le lien

Les faits de votre compte (invitation, acceptation, message, réponse, étape posée…) deviennent des événements, lisibles par l'API et livrés à vos webhooks. La plupart sont enregistrés dans la minute ; ceux d'une action faite par l'API, comme cette simulation, en général tout de suite après elle.

curl "https://api.lidmeo.com/v1/events?type=invitation.accepted" \
  -H "Authorization: Bearer $LIDMEO_API_KEY"

L'événement porte dans data.object le prospect tel qu'il était quand l'événement a été enregistré. Pour le recevoir sur votre serveur, créez une adresse de réception avec cette même clé de test : les adresses du compte de test se créent par l'API, l'écran Intégrations ne montre que celles du compte réel.

Passez au réelCopier le lien

Dans Intégrations, créez une clé avec Votre compte (réel) sous Données : elle commence par lid_live_. Ne lui donnez que les droits dont votre programme a besoin. Le droit d'envoyer (sends:write) ne se donne pas par défaut : cochez-le seulement si votre programme valide des invitations ou envoie des messages. Le même code tourne à l'identique : seule la clé change.