Bulk Set Account State

POST

account-states

bulk

curl -X POST "https://api.clustr-ai.com/api/public/account-states/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_ids": ["9c4d5e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f", "7a1b2c3d-4e5f-4061-8a2b-3c4d5e6f7081"],
    "owner_id": "3f2b1c40-8a11-4f2e-9d61-0f5a8c7a2b13",
    "push_to_crm": true
  }'

{
  "success": true,
  "data": {
    "updated": 2,
    "intros_moved": 0,
    "crmPush": {
      "status": "pushed",
      "provider": "hubspot",
      "pushed": 1,
      "notPushed": 1,
      "message": "one account is not matched to a HubSpot company"
    }
  }
}

{
  "success": false,
  "error": { "message": "cannot update more than 1000 accounts at once", "code": "BAD_REQUEST" }
}

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.

Body

string[]

required

Up to 1000 company UUIDs. More is a 400, not a truncation.

string

A tier id, or "" to clear.

string

An owner id, or "" to clear.

boolean

string

boolean

default:"false"

Also write the owner to each matched CRM company. Ignored without owner_id; a cleared owner is never pushed. pushToCrm is the same flag.

string

deprecated

Deprecated — a status is a tag. It writes the account tag the former status became. Use Bulk Set Record Tags.

Response Fields

integer

How many account-state rows were written.

integer

How many warm intros followed an is_discarded change, across the whole selection.

object

Present only when an owner was written and the CRM was involved. Same shape as on Set Account State; pushed and notPushed count records across the selection.

curl -X POST "https://api.clustr-ai.com/api/public/account-states/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_ids": ["9c4d5e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f", "7a1b2c3d-4e5f-4061-8a2b-3c4d5e6f7081"],
    "owner_id": "3f2b1c40-8a11-4f2e-9d61-0f5a8c7a2b13",
    "push_to_crm": true
  }'

{
  "success": true,
  "data": {
    "updated": 2,
    "intros_moved": 0,
    "crmPush": {
      "status": "pushed",
      "provider": "hubspot",
      "pushed": 1,
      "notPushed": 1,
      "message": "one account is not matched to a HubSpot company"
    }
  }
}

{
  "success": false,
  "error": { "message": "cannot update more than 1000 accounts at once", "code": "BAD_REQUEST" }
}

curl -X POST "https://api.clustr-ai.com/api/public/account-states/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_ids": ["9c4d5e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f", "7a1b2c3d-4e5f-4061-8a2b-3c4d5e6f7081"],
    "owner_id": "3f2b1c40-8a11-4f2e-9d61-0f5a8c7a2b13",
    "push_to_crm": true
  }'

{
  "success": true,
  "data": {
    "updated": 2,
    "intros_moved": 0,
    "crmPush": {
      "status": "pushed",
      "provider": "hubspot",
      "pushed": 1,
      "notPushed": 1,
      "message": "one account is not matched to a HubSpot company"
    }
  }
}

{
  "success": false,
  "error": { "message": "cannot update more than 1000 accounts at once", "code": "BAD_REQUEST" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

Bulk Set Account State

Body

Response Fields

​Body

​Response Fields

Body

Response Fields