---
title: "Update a Contact"
method: PATCH
path: "/contacts/{contact_id}"
tags: ["Contacts"]
---

# Update a Contact

`PATCH /contacts/{contact_id}`

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 Update a Contact endpoint to update existing contacts in your team's Apollo account.<br><br>To create a new contact, use the <a href="https://docs.apollo.io/reference/create-a-contact">Create a Contact endpoint</a> instead. To update the contact stage for multiple contacts, use the <a href="https://docs.apollo.io/reference/update-contact-stage">Update Contact Stage for Multiple Contacts</a> endpoint.

## Path parameters

- `contact_id` string, required

## Request body

- object
  - `first_name` string — Update the contact's first name. Example: `Tim`
  - `last_name` string — Update the contact's last name. Example: `Zheng`
  - `organization_name` string — Update the employer (company) name. Example: `apollo`
  - `title` string — Update the job title. Example: `senior research analyst`
  - `account_id` string — Update the account ID. Example: `63f53afe4ceeca00016bdd2f`
  - `email` string — Update the contact email. Example: `example@email.com`
  - `website_url` string — Update the employer website URL. Example: `https://www.apollo.io/`
  - `label_names` string[] — Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)
  - `contact_stage_id` string — Update the contact stage ID. Example: `6095a710bd01d100a506d4af`
  - `present_raw_address` string — Update location (city/state/country). Example: `Atlanta, United States`
  - `direct_phone` string — Primary phone.
  - `corporate_phone` string — Work/office phone.
  - `mobile_phone` string — Mobile phone.
  - `home_phone` string — Home phone.
  - `other_phone` string — Alternate phone.
  - `typed_custom_fields` object — Add information to <a href="https://knowledge.apollo.io/hc/en-us/articles/4412498825869-Create-Custom-Contact-Fields" target="_blank">custom fields</a> in Apollo. <br><br><b>Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.</b> <br><br>To utilize this parameter successfully, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value. <br><br><b>Example</b>: When the <a href="https://docs.apollo.io/reference/get-a-list-of-all-custom-fields">Get a List of All Custom Fields</a> endpoint returns an `id` of field: * `"60c39ed82bd02f01154c470a"` (datetime) then the value passed should be: `{"60c39ed82bd02f01154c470a": "2025-08-07"}`

## Response `200`

200

- object
  - `contact` 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` string
    - `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` string
    - `merged_crm_ids` unknown
    - `updated_at` string
    - `queued_for_crm_push` boolean
    - `suggested_from_rule_engine_config_id` unknown
    - `email_unsubscribed` unknown
    - `label_ids` string[]
    - `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` object
    - `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_emails` unknown[]
      - unknown
    - `next_contact_id` unknown
    - `time_zone` string
    - `city` string
    - `state` string
    - `country` string
    - `intent_strength` unknown
    - `show_intent` boolean
    - `phone_numbers` object[]
      - `raw_number` string
      - `sanitized_number` string
      - `type` string
      - `position` integer
      - `status` string
      - `dnc_status` unknown
      - `dnc_other_info` unknown
      - `dialer_flags` unknown
    - `account_phone_note` unknown
    - `free_domain` boolean
    - `is_likely_to_engage` boolean
    - `email_domain_catchall` boolean
  - `labels` object[]
    - `id` string
    - `modality` string
    - `cached_count` integer
    - `name` string
    - `created_at` string
    - `updated_at` string
    - `user_id` string

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