v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Contacts

Update a Contact

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. Use the Update a Contact endpoint to update existing contacts in your team's Apollo account. 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.

patch/contacts/{contact_id}

Path parameters

contact_idstring required

The Apollo ID for the contact 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

Request body

first_namestring

Update the contact's first name. Example: Tim

last_namestring

Update the contact's last name. Example: Zheng

organization_namestring

Update the employer (company) name. Example: apollo

titlestring

Update the job title. Example: senior research analyst

account_idstring

Update the account ID. Example: 63f53afe4ceeca00016bdd2f

emailstring

Update the contact email. Example: example@email.com

website_urlstring

Update the employer website URL. Example: https://www.apollo.io/

label_namesstring[]

Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)

contact_stage_idstring

Update the contact stage ID. Example: 6095a710bd01d100a506d4af

present_raw_addressstring

Update location (city/state/country). Example: Atlanta, United States

direct_phonestring

Primary phone.

corporate_phonestring

Work/office phone.

mobile_phonestring

Mobile phone.

home_phonestring

Home phone.

other_phonestring

Alternate phone.

typed_custom_fieldsobject

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. 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. 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. Example: 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"}

Example request

{
  "typed_custom_fields": {
    "60c39ed82bd02f01154c470a": "2025-08-07"
  }
}

Response

200

Example response

{
  "contact": {
    "id": "66e34b81740c50074e3d1bd4",
    "first_name": "Fyodor",
    "last_name": "Dostoevsky",
    "name": "Fyodor Dostoevsky",
    "title": "Chief Writer",
    "contact_stage_id": "6095a710bd01d100a506d4ae",
    "owner_id": "60affe7d6e270a00f5db6fe4",
    "creator_id": "60affe7d6e270a00f5db6fe4",
    "organization_name": "Apollo.io",
    "source": "api",
    "original_source": "api",
    "organization_id": "5e66b6381e05b4008c8331b8",
    "present_raw_address": "St. Petersburg, Russia",
    "created_at": "2024-09-12T20:13:53.207Z",
    "email_status": "verified",
    "account_id": "63f53afe4ceeca00016bdd2f",
    "sanitized_phone": "+15555550117",
    "updated_at": "2024-09-12T20:14:53.134Z",
    "label_ids": [
      "66e361494acd1307386d4073"
    ],
    "existence_level": "full",
    "email": "fyodor.dostoevsky@apollo.io",
    "email_from_customer": true,
    "email_true_status": "User Managed",
    "updated_email_true_status": true,
    "source_display_name": "Created from API",
    "time_zone": "Asia/Krasnoyarsk",
    "city": "Saint Petersburg",
    "state": "Saint Petersburg",
    "country": "Russia",
    "phone_numbers": [
      {
        "raw_number": "555-555-0117",
        "sanitized_number": "+15555550117",
        "type": "work_direct",
        "status": "no_status"
      }
    ]
  },
  "labels": [
    {
      "id": "66e361494acd1307386d4073",
      "modality": "contacts",
      "name": "2024 fiction writers of america attendees",
      "created_at": "2024-09-12T21:46:49.464Z",
      "updated_at": "2024-09-12T21:46:49.544Z",
      "user_id": "60affe7d6e270a00f5db6fe4"
    }
  ]
}