---
title: "Bulk Update Contacts"
method: POST
path: "/contacts/bulk_update"
tags: ["Contacts"]
---

# Bulk Update Contacts

`POST /contacts/bulk_update`

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

<a href="https://knowledge.apollo.io/hc/en-us/articles/5995459280525-View-and-Edit-Contacts" target="_blank">Contacts</a> are people saved in Apollo.<br><br>Use the Bulk Update Contacts endpoint to update multiple contacts in your team's Apollo account simultaneously. <br><br>This endpoint allows you to update common fields across multiple contacts efficiently, such as contact stages, owners, custom fields, and other contact attributes. <br><br>You can update up to 1000 contacts per request; requests with more than 1000 contacts are rejected with a <code>422</code> error. Requests of 100 or fewer contacts are processed synchronously and return the updated contacts immediately. Requests of 101 to 1000 contacts are processed asynchronously. You can also force asynchronous processing at any batch size by setting the <code>async</code> parameter to <code>true</code>.

## Request body

- union
  - object
    - `contact_ids` string[], required — Array of contact IDs to update with the same values. Use this for applying the same updates to multiple contacts.
    - `contact_attributes` object[] — Array of contact objects with individual updates. Use this for applying different updates to each contact.
      - `id` string, required — The contact ID to update
      - `first_name` string — The contact's first name
      - `last_name` string — The contact's last name
      - `email` string — The contact's email address
      - `title` string — The contact's job title
      - `organization_name` string — The contact's organization name
      - `owner_id` string — The Apollo user ID to assign as owner
      - `account_id` string — The Apollo account ID to associate with the contact
      - `present_raw_address` string — The contact's location
      - `linkedin_url` string — The contact's LinkedIn profile URL
      - `typed_custom_fields` object — Custom field values as key-value pairs
    - `owner_id` string — When using contact_ids, apply this owner to all contacts
    - `email` string — When using contact_ids, apply this email to all contacts
    - `organization_name` string — When using contact_ids, apply this organization name to all contacts
    - `title` string — When using contact_ids, apply this title to all contacts
    - `first_name` string — When using contact_ids, apply this first name to all contacts
    - `last_name` string — When using contact_ids, apply this last name to all contacts
    - `account_id` string — When using contact_ids, apply this account ID to all contacts
    - `present_raw_address` string — When using contact_ids, apply this address to all contacts
    - `linkedin_url` string — When using contact_ids, apply this LinkedIn URL to all contacts
    - `typed_custom_fields` object — When using contact_ids, apply these custom fields to all contacts
    - `async` boolean — Force asynchronous processing. Automatically enabled for >100 contacts.
    - `visible_entity_ids` string[] — Specific contact IDs to return in the response (for performance)
  - object
    - `contact_ids` string[] — Array of contact IDs to update with the same values. Use this for applying the same updates to multiple contacts.
    - `contact_attributes` object[], required — Array of contact objects with individual updates. Use this for applying different updates to each contact.
      - `id` string, required — The contact ID to update
      - `first_name` string — The contact's first name
      - `last_name` string — The contact's last name
      - `email` string — The contact's email address
      - `title` string — The contact's job title
      - `organization_name` string — The contact's organization name
      - `owner_id` string — The Apollo user ID to assign as owner
      - `account_id` string — The Apollo account ID to associate with the contact
      - `present_raw_address` string — The contact's location
      - `linkedin_url` string — The contact's LinkedIn profile URL
      - `typed_custom_fields` object — Custom field values as key-value pairs
    - `owner_id` string — When using contact_ids, apply this owner to all contacts
    - `email` string — When using contact_ids, apply this email to all contacts
    - `organization_name` string — When using contact_ids, apply this organization name to all contacts
    - `title` string — When using contact_ids, apply this title to all contacts
    - `first_name` string — When using contact_ids, apply this first name to all contacts
    - `last_name` string — When using contact_ids, apply this last name to all contacts
    - `account_id` string — When using contact_ids, apply this account ID to all contacts
    - `present_raw_address` string — When using contact_ids, apply this address to all contacts
    - `linkedin_url` string — When using contact_ids, apply this LinkedIn URL to all contacts
    - `typed_custom_fields` object — When using contact_ids, apply these custom fields to all contacts
    - `async` boolean — Force asynchronous processing. Automatically enabled for >100 contacts.
    - `visible_entity_ids` string[] — Specific contact IDs to return in the response (for performance)

## Response `200`

200

- union
  - object
    - `contacts` object[]
      - `id` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `title` string
      - `organization_name` string
      - `owner_id` string
      - `account_id` string
      - `present_raw_address` string
      - `linkedin_url` string
      - `updated_at` string, date-time
  - object
    - `entity_progress_job` object
      - `id` string
      - `job_type` string
      - `status` string
      - `entity_ids` string[]
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401` — 401
- `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)