LidmeoDevelopers

Agencies

Acting on several client accounts with a single access: the Lidmeo-Account header.

An agency (Team plan) gathers several accounts: one per LinkedIn account. Each account has its own prospects, campaigns, conversations and webhooks. An agency access covers them all; each call says which one it targets.

One access for the whole agency

  • An OAuth connection at agency level: when connecting, the owner or an administrator of the team chooses All your LinkedIn accounts. This is how an AI assistant or an application sees all your client accounts.
  • An agency key (lid_org_live_…, lid_org_test_…) follows the same rule. Agency keys cannot be created yet from the "Assistant IA et intégrations" page; meanwhile, each account can create its own key.

Naming the account

First list the accounts the access covers:

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

Each account says whether its subscription is active, its LinkedIn account connected and its prospecting running. Then pass its id in the Lidmeo-Account header of every call that touches its data:

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" });
// or, call by call:
await lidmeo.prospects.list({}, { account: "acct_1J4kQ8sLr2Xw" });
  • Without the header: 400 account_required.
  • An account outside the agency: 403 account_not_found.
  • GET /v1/me and GET /v1/accounts don't need the header.

Good to know

  • Rate limits are counted for the whole agency, on a larger budget than a single account: see rate limits.
  • In test mode, an acct_… id designates that account's test account: the same code runs on the test accounts, then on the real ones.
  • Webhooks belong to an account: create one endpoint per account, with the Lidmeo-Account header. Every event carries account.
  • The "client" role of a team (your end client) can create keys for their own account, without the right to update campaigns, as in the Lidmeo screen.

On this page