Bulk Update Contacts

post

https://api.apollo.io/api/v1/contacts/bulk_update

Use the Bulk Update Contacts endpoint to update multiple contacts in your team's Apollo account simultaneously.

This endpoint allows you to update common fields across multiple contacts efficiently, such as contact stages, owners, custom fields, and other contact attributes.

You can update up to 100 contacts per request. For larger batches, the system will process the updates asynchronously.

Body Params

contact_ids

array of strings

required

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

contact_ids*

contact_attributes

array of objects

Array of contact objects with individual updates. Use this for applying different updates to each contact.

contact_attributes

owner_id

string

When using contact_ids, apply this owner to all contacts

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

array of strings

Specific contact IDs to return in the response (for performance)

visible_entity_ids

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200200

401401

422422

429429