Skip to main content
POST
Add target accounts, a batch at a time, in target_companies. The call is additive: accounts already on your list are left as they are, and an entry with a blank name is skipped, so a spreadsheet’s empty trailing row does not fail the import. added counts the accounts added.

LinkedIn URL

Every new account needs its LinkedIn company page URL: linkedin.com/company/acme, or the company’s numeric id, linkedin.com/company/1035. With or without https://www., a trailing slash or a query string. A person’s profile, a school page or a showcase page is refused. Clustr checks the URL’s shape only. To find it, search the company on LinkedIn and copy the address of its page. An entry without a valid URL is not added and is listed in rejected with its position in the request and the reason. The other entries are added. When no entry is left to add, the call answers 422 with code INVALID_LINKEDIN_URL.

Tier

Each entry may carry a tier: the name your workspace uses for it, from List Account Tiers. An unknown tier name rejects the whole batch rather than creating the tier or quietly dropping it. A typo in a 500-row import would otherwise become a permanent tier nobody chose, and a dropped one loses data you believed you sent. The error names both the tier you sent and the row it was on. A tier belongs to the company behind an account, and a brand-new account has usually not been matched to one yet. When that happens the tier is queued on the account and applied automatically as soon as the match happens, so nothing is lost in the gap. You do not have to poll or re-send it.

Tag

Each entry may carry a tag: one of your account tags, as your workspace spells it, from List Tags. The tag is added to the account, also when the company is already on your list. An unknown tag name rejects the whole batch. Tags are never created this way.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Body

application/json
target_companies
object[]
required

The accounts to add.

Response

The accounts were added; added counts them and rejected lists the entries left out.

success
boolean
required
data
object
required