---
title: "Update Contact Stage for Multiple Contacts"
method: POST
path: "/contacts/update_stages"
tags: ["Contacts"]
---

# Update Contact Stage for Multiple Contacts

`POST /contacts/update_stages`

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/4410623601165-Contact-and-Account-Stages-Overview" target="_blank">Contact stages</a> help you track progress on sales and marketing pipelines.<br><br>Use the Update Contact Stage for Multiple Contacts endpoint to update the contact stage for several contacts in your team's Apollo account.<br><br>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.

## Query parameters

- `contact_ids[]` string[], required
- `contact_stage_id` string, required

## Response `200`

200

- object
  - `contacts` object[]
    - `contact_roles` unknown[]
      - unknown
    - `id` string
    - `first_name` string
    - `last_name` string
    - `name` string
    - `linkedin_url` unknown
    - `title` string
    - `contact_stage_id` string
    - `owner_id` string
    - `creator_id` string
    - `person_id` unknown
    - `email_needs_tickling` unknown
    - `organization_name` string
    - `source` string
    - `original_source` string
    - `organization_id` string
    - `headline` unknown
    - `photo_url` unknown
    - `present_raw_address` unknown
    - `linkedin_uid` unknown
    - `extrapolated_email_confidence` number, nullable
    - `salesforce_id` unknown
    - `salesforce_lead_id` unknown
    - `salesforce_contact_id` unknown
    - `salesforce_account_id` unknown
    - `crm_owner_id` unknown
    - `created_at` string
    - `emailer_campaign_ids` unknown[]
      - unknown
    - `direct_dial_status` unknown
    - `direct_dial_enrichment_failed_at` unknown
    - `email_status` string
    - `email_source` unknown
    - `account_id` string
    - `last_activity_date` unknown
    - `hubspot_vid` unknown
    - `hubspot_company_id` unknown
    - `crm_id` unknown
    - `sanitized_phone` unknown
    - `merged_crm_ids` unknown
    - `updated_at` string
    - `queued_for_crm_push` boolean
    - `suggested_from_rule_engine_config_id` unknown
    - `email_unsubscribed` unknown
    - `label_ids` unknown[]
      - unknown
    - `has_pending_email_arcgate_request` boolean
    - `has_email_arcgate_request` boolean
    - `existence_level` string
    - `email` string
    - `email_from_customer` boolean
    - `typed_custom_fields` object
    - `custom_field_errors` unknown
    - `crm_record_url` unknown
    - `email_status_unavailable_reason` unknown
    - `email_true_status` string
    - `updated_email_true_status` boolean
    - `contact_rule_config_statuses` unknown[]
      - unknown
    - `source_display_name` string
    - `twitter_url` unknown
    - `contact_campaign_statuses` unknown[]
      - unknown
    - `contact_emails` unknown[]
      - unknown
    - `intent_strength` unknown
    - `show_intent` boolean
    - `phone_numbers` unknown[]
      - unknown
    - `account_phone_note` unknown
    - `free_domain` boolean
    - `is_likely_to_engage` boolean
    - `email_domain_catchall` boolean

## 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)