Add companies to Key Accounts
Add one or more companies to Key Accounts on behalf of a user in your account. Companies in Key Accounts unlock deep research (news, job changes, org chart, etc.).
Companies already in Key Accounts are returned separately and not re-charged. Costs 1 credit per newly-added company.
Newly-added companies are queued for data backfill — fresh data may take a few minutes to appear.
Authorizations
Account API key passed in the Authorization header
Body
LinkedIn numeric IDs of companies to add to Key Accounts. Resolve names/domains via Search for a company first.
1 - 50 elements["104924588"]
Email of a user in your account. Companies are added to this user's Key Accounts.
"elliot.alderson@tamtam.ai"
Optional free-form labels (e.g. 'strategic', 'renewal-q2'). Replaces existing tags on each company.
["strategic"]
Optional priority tier for the added companies. Higher = higher priority. Defaults to 1.
1 <= x <= 31
Response
OK
LinkedIn IDs that were already in Key Accounts (no credits charged).
LinkedIn IDs skipped because the account ran out of credits mid-batch.
LinkedIn IDs successfully added to Key Accounts (1 credit charged per ID).
True when the account ran out of credits during the request. Some companies in the batch may still have succeeded.
Tags applied to the unlocked companies (echoed back from the request).
Priority tier applied to the added companies.