Skip to main content
POST
Add companies to Key Accounts

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Body

application/json
company_linkedin_ids
string[] | null
required

LinkedIn numeric IDs of companies to add to Key Accounts. Resolve names/domains via Search for a company first.

Required array length: 1 - 50 elements
Example:
user_email
string<email>
required

Email of a user in your account. Companies are added to this user's Key Accounts.

Example:

"elliot.alderson@tamtam.ai"

tags
string[] | null

Optional free-form labels (e.g. 'strategic', 'renewal-q2'). Replaces existing tags on each company.

Example:
tier_level
integer<int32>

Optional priority tier for the added companies. Higher = higher priority. Defaults to 1.

Required range: 1 <= x <= 3
Example:

1

Response

OK

already_in_key_accounts_linkedin_ids
string[] | null
required

LinkedIn IDs that were already in Key Accounts (no credits charged).

ignored_company_linkedin_ids
string[] | null
required

LinkedIn IDs skipped because the account ran out of credits mid-batch.

newly_added_company_linkedin_ids
string[] | null
required

LinkedIn IDs successfully added to Key Accounts (1 credit charged per ID).

payment_required
boolean
required

True when the account ran out of credits during the request. Some companies in the batch may still have succeeded.

tags
string[] | null
required

Tags applied to the unlocked companies (echoed back from the request).

tier_level
integer<int32>
required

Priority tier applied to the added companies.