---
title: "Bulk Update Accounts"
method: POST
path: "/accounts/bulk_update"
tags: ["Accounts"]
---

# Bulk Update Accounts

`POST /accounts/bulk_update`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

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.

## Request body

- object
  - `account_ids` string[] — Array of account IDs to update with the same values. Use this for applying the same updates to multiple accounts.
  - `account_attributes` object[] — Array of account objects with individual updates. Use this for applying different updates to each account.
    - `id` string, required — The account ID to update
    - `name` string — The account name
    - `owner_id` string — The Apollo user ID to assign as owner
    - `account_stage_id` string — The Apollo account stage ID
    - `typed_custom_fields` object — Custom field values as key-value pairs
  - `name` string — When using account_ids, apply this name to all accounts
  - `owner_id` string — When using account_ids, apply this owner to all accounts
  - `account_stage_id` string — When using account_ids, apply this account stage to all accounts
  - `async` boolean — Set to true to process updates asynchronously. Only available when using account_ids. Not supported with account_attributes.

## Response `200`

200

- object
  - `accounts` object[]
    - `id` string
    - `account_stage_id` string

## Other responses

- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)