Sign in

v1

latestOpenAPI 3.1.02026-07-247601.0 MB
Accounts

Bulk Update Accounts

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

An <a href="https://knowledge.apollo.io/hc/en-us/articles/5995865049229-View-and-Edit-Accounts" target="_blank">account</a> is a company saved in Apollo.<br><br>Use the Bulk Update Accounts endpoint to simultaneously update multiple accounts in your team's Apollo account. <br><br>This endpoint allows you to update common fields across multiple accounts efficiently, such as account stages, owners, names, and custom fields. <br><br>You can update up to 1,000 accounts per request.<br><br><b>Important:</b> Asynchronous processing (async parameter) is only supported when using <code>account_ids</code> to apply the same updates to all accounts. If you use async with <code>account_attributes</code> (individual updates per account), the request fails with a 422 error.

post/accounts/bulk_update

Request body

account_idsstring[]

Array of account IDs to update with the same values. Use this for applying the same updates to multiple accounts.

namestring

When using account_ids, apply this name to all accounts

owner_idstring

When using account_ids, apply this owner to all accounts

account_stage_idstring

When using account_ids, apply this account stage to all accounts

asyncboolean

Set to true to process updates asynchronously. Only available when using account_ids. Not supported with account_attributes.

Example request

{
  "account_ids": [
    "66e9abf95ac32901b20d1a0d",
    "66e9a4db056fe802d331fb8a"
  ],
  "account_attributes": [
    {
      "id": "66e9abf95ac32901b20d1a0d",
      "name": "Acme Corporation",
      "owner_id": "66302798d03b9601c7934ebf",
      "account_stage_id": "6095a710bd01d100a506d4b7",
      "typed_custom_fields": {
        "60c39ed82bd02f01154c470a": "2025-08-07"
      }
    }
  ],
  "name": "Updated Account Name",
  "owner_id": "66302798d03b9601c7934ebf",
  "account_stage_id": "6095a710bd01d100a506d4b7"
}

Response

200

Example response

{
  "accounts": [
    {
      "id": "66e9abf95ac32901b20d1a0d",
      "account_stage_id": "6095a710bd01d100a506d4b7"
    }
  ]
}