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/meandGET /v1/accountsdon'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-Accountheader. Every event carriesaccount. - 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.