Skip to main content
POST
Adds many companies to your target accounts at once. Send up to 1,000 rows per request (the queries.target_accounts.import_max_rows setting); split a longer file into several requests. Each row is checked on its own. Valid rows are added, invalid rows come back in invalid with their row number and the reason, and one bad row never blocks the others. A row’s number is its row, else its position in rows, from 1.
  • name needs at least 2 characters and must not be a URL. A bare domain like Booking.com is a name; https://acme.com, www.acme.com or a LinkedIn link is not: put a LinkedIn page in linkedin_url.
  • linkedin_url is optional. When sent it must be a LinkedIn company page (linkedin.com/company/acme, or /company/ and its numeric id), stored in its canonical form.
Re-running an import is safe. A row already on your list (the same LinkedIn page, else the same name), or repeated within the request, is counted in already_listed. Tiers and tags are named, never created. tier files the account under one of your tiers and tag adds one of your account tags, both as your workspace spells them. A tag is applied to rows already on the list too, once the row has matched a company. An unknown tier or tag fails the whole request with 400, so a typo never files every row somewhere nobody chose.

Errors

Authorizations

Authorization
string
header
required

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

Body

application/json
rows
object[]
required
Minimum array length: 1

Response

Envelope whose data is {added, already_listed, invalid}.

success
boolean
required
data
object
required