Sign in

v1

latestOpenAPI 3.1.02026-07-247601.0 MB
Contacts

Bulk Update Contacts

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

<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>.

post/contacts/bulk_update

Request body

OR

Example request

{
  "contact_ids": [
    "66e34b81740c50074e3d1bd4",
    "66e370fbf5f5c003f0e1d0cf"
  ],
  "contact_attributes": [
    {
      "id": "66e34b81740c50074e3d1bd4",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "title": "Senior Manager",
      "organization_name": "Example Corp",
      "owner_id": "66302798d03b9601c7934ebf",
      "account_id": "63f53afe4ceeca00016bdd2f",
      "present_raw_address": "San Francisco, CA",
      "linkedin_url": "https://www.linkedin.com/in/john-doe-3f9a7c21",
      "typed_custom_fields": {
        "60c39ed82bd02f01154c470a": "2025-08-07"
      }
    }
  ],
  "owner_id": "66302798d03b9601c7934ebf",
  "email": "updated@example.com",
  "organization_name": "Updated Corp",
  "title": "Updated Title",
  "first_name": "Updated",
  "last_name": "Name",
  "account_id": "63f53afe4ceeca00016bdd2f",
  "present_raw_address": "New York, NY",
  "linkedin_url": "https://www.linkedin.com/in/updated",
  "typed_custom_fields": {
    "60c39ed82bd02f01154c470a": "2025-08-07"
  },
  "visible_entity_ids": [
    "66e34b81740c50074e3d1bd4"
  ]
}

Response

200

OR

Example response

{
  "contacts": [
    {
      "id": "66e34b81740c50074e3d1bd4",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "title": "Senior Manager",
      "organization_name": "Example Corp",
      "owner_id": "66302798d03b9601c7934ebf",
      "account_id": "63f53afe4ceeca00016bdd2f",
      "present_raw_address": "San Francisco, CA",
      "linkedin_url": "https://www.linkedin.com/in/john-doe-3f9a7c21",
      "updated_at": "2024-09-12T10:30:00.000Z"
    }
  ]
}