Skip to main content
PUT
Creates the account’s state or updates it. Only provided fields change. Tags are shared by accounts, people and opportunities, and have their own endpoint: Set An Account’s Tags.
An empty string on tier_id clears it. Omitting the field leaves it alone, so send an explicit "" to clear it.
An account’s Sales owner and CS owner come from your CRM and are not set here.

Authorizations

Authorization
string
header
required

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

Path Parameters

account_id
string
required

The account: its acc_ Clustr id, or the company uuid.

Body

application/json
tier_id
string | null
status_id
string | null
is_discarded
boolean
intros
enum<string>

With is_discarded: whether the account's open intros follow it (the default) or keep their state.

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

The stored account state.

success
boolean
required
data
object
required

account_state and intros_moved (the warm intros the discard change carried), with fit (the grade the write produced) when the account is graded, and crmPush / csCrmPush when an owner write went to the CRM.