v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Contacts

Update Contact Stage for Multiple 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/4410623601165-Contact-and-Account-Stages-Overview" target="_blank">Contact stages</a> help you track progress on sales and marketing pipelines. Use the Update Contact Stage for Multiple Contacts endpoint to update the contact stage for several contacts in your team's Apollo account. To update more than the contact stage, such as job titles or contact details, use the <a href="https://docs.apollo.io/reference/update-a-contact">Update a Contact endpoint</a> instead.

post/contacts/update_stages

Query parameters

contact_ids[]string[] required

The Apollo IDs for the contacts that you want to update. To find contact IDs, call the <a href="https://docs.apollo.io/reference/search-for-contacts" target="_blank">Search for Contacts endpoint</a> and identify the id value for the contact. Example: 66e34b81740c50074e3d1bd4

contact_stage_idstring required

The Apollo ID for the contact stage to which you want to assign the contacts. Call the <a href="https://docs.apollo.io/reference/list-contact-stages" target="_blank">List Contact Stages endpoint</a> to retrieve a list of all the contact stage IDs available in your Apollo account. Example: 6095a710bd01d100a506d4af

Response

200

Example response

{
  "contacts": [
    {
      "id": "66e3726977d36c03f2c30afc",
      "first_name": "Walt",
      "last_name": "Whitman",
      "name": "Walt Whitman",
      "title": "Associate Writer",
      "contact_stage_id": "6095a710bd01d100a506d4b2",
      "owner_id": "60affe7d6e270a00f5db6fe4",
      "creator_id": "60affe7d6e270a00f5db6fe4",
      "organization_name": "Apollo.io",
      "source": "api",
      "original_source": "api",
      "organization_id": "5e66b6381e05b4008c8331b8",
      "created_at": "2024-09-12T22:59:53.423Z",
      "email_status": "verified",
      "account_id": "63f53afe4ceeca00016bdd2f",
      "updated_at": "2024-09-13T00:12:09.547Z",
      "existence_level": "full",
      "email": "wwhitman@apollo.io",
      "email_from_customer": true,
      "email_true_status": "User Managed",
      "updated_email_true_status": true,
      "source_display_name": "Created from API"
    }
  ]
}