LidmeoDevelopers

Agences

Agir sur plusieurs comptes clients avec un seul accès : l'en-tête Lidmeo-Account.

Une agence (offre Team) réunit plusieurs comptes : un par compte LinkedIn. Chaque compte a ses propres prospects, campagnes, conversations et webhooks. Un accès d'agence les couvre tous ; chaque appel dit lequel il vise.

Un accès pour toute l'agence

  • Une connexion OAuth au niveau de l'agence : à la connexion, le titulaire ou un administrateur de l'équipe choisit Tous les comptes de l'agence. C'est ainsi qu'un assistant IA ou une application voit tous vos comptes clients.
  • Une clé d'agence (lid_org_live_…, lid_org_test_…) suit la même règle. Les clés d'agence arrivent dans le portail ; en attendant, chaque compte peut créer sa propre clé.

Nommer le compte

Listez d'abord les comptes que l'accès couvre :

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

Chaque compte dit si son abonnement est actif, si son compte LinkedIn est connecté et si sa prospection tourne. Puis passez son identifiant dans l'en-tête Lidmeo-Account de chaque appel qui touche ses données :

curl https://api.lidmeo.com/v1/prospects \
  -H "Authorization: Bearer $LIDMEO_TOKEN" \
  -H "Lidmeo-Account: acct_1J4kQ8sLr2Xw"
const lidmeo = new Lidmeo({ apiKey: process.env.LIDMEO_TOKEN, account: "acct_1J4kQ8sLr2Xw" });
// ou, appel par appel :
await lidmeo.prospects.list({}, { account: "acct_1J4kQ8sLr2Xw" });
  • Sans l'en-tête : 400 account_required.
  • Un compte hors de l'agence : 403 account_not_found.
  • GET /v1/me et GET /v1/accounts se passent de l'en-tête.

Ce qu'il faut savoir

  • Les limites de débit se comptent pour toute l'agence, sur un budget plus large qu'un compte seul : voir les limites.
  • En mode test, un identifiant acct_… désigne le compte de test de ce compte : le même code tourne sur les comptes de test, puis sur les vrais.
  • Les webhooks appartiennent à un compte : créez une adresse de réception par compte, avec l'en-tête Lidmeo-Account. Chaque événement porte account.
  • Le rôle « client » d'une équipe (votre client final) peut créer des clés pour son propre compte, sans le droit de modifier les campagnes, comme dans l'écran de Lidmeo.

Sur cette page