Skip to main content
POST
Same fields as Set Account State, applied to every id in company_ids. Up to 1000 accounts in one call. Tags across a selection go through Bulk Set Record Tags instead.

Authorizations

Authorization
string
header
required

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

Body

application/json
company_ids
string<uuid>[]
filters

The Accounts list query, in place of company_ids: an object of parameter to value(s), e.g. {"segment": "target", "tier": ["..."]}. The query string itself, as a JSON string, is accepted too.

tier_id
string | null

The tier to set (its Clustr id); an empty string clears it.

status_id
string | null
is_discarded
boolean
intros
enum<string>

What an is_discarded change does to the warm intros at these accounts. follow (the default) carries it onto them, keep leaves them as they are.

Available options:
follow,
keep
notes
string

The note. An empty or whitespace-only string clears it.

dismiss_reason
string

Why this dismissal happens, with is_discarded true. Never written into notes.

Response

How many account-state rows were written.

success
boolean
required
data
object
required

What a bulk state write did. updated and intros_moved always; matched for a filter selection; fits (by company uuid) for ticked rows that are graded; crmPush / csCrmPush when an owner write went to the CRM.