Skip to main content
POST
/
v2
/
key-accounts
Add companies to Key Accounts
curl --request POST \
  --url https://api.tamtam.ai/api/v2/key-accounts \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_linkedin_ids": [
    "<string>"
  ],
  "user_email": "jsmith@example.com",
  "tags": [
    "<string>"
  ],
  "tier_level": 2
}
'
{
  "already_in_key_accounts_linkedin_ids": [
    "<string>"
  ],
  "ignored_company_linkedin_ids": [
    "<string>"
  ],
  "newly_added_company_linkedin_ids": [
    "<string>"
  ],
  "payment_required": true,
  "tags": [
    "<string>"
  ],
  "tier_level": 123
}

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:
["104924588"]
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:
["strategic"]
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.