---
title: "Update contact"
method: PATCH
path: "/crm/contacts/{id}"
tags: ["Contacts"]
---

# Update contact

`PATCH /crm/contacts/{id}`

Update contact

## Path parameters

- `id` string, required

## Query parameters

- `raw` boolean

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string

## Request body

- Contact
  - `id` string — Unique identifier for the contact.
  - `name` string, nullable — Full name of the contact.
  - `owner_id` string, nullable — The owner of the contact.
  - `type` 'customer' | 'supplier' | 'employee' | 'personal', nullable — The type of the contact.
  - `company_id` string, nullable — The company the contact is associated with.
  - `company_name` string, nullable — The name of the company the contact is associated with.
  - `lead_id` string, nullable — The lead the contact is associated with.
  - `first_name` string, nullable — The first name of the contact.
  - `middle_name` string, nullable — The middle name of the contact.
  - `last_name` string, nullable — The last name of the contact.
  - `prefix` string, nullable — The prefix of the contact.
  - `suffix` string, nullable — The suffix of the contact.
  - `title` string, nullable — The job title of the contact.
  - `department` string, nullable — The department of the contact.
  - `language` string, nullable — language code according to ISO 639-1. For the United States - EN
  - `gender` 'male' | 'female' | 'unisex', nullable — The gender of the contact.
  - `birthday` string, nullable — The birthday of the contact.
  - `image` string, nullable
  - `photo_url` string, nullable — The URL of the photo of a person.
  - `lead_source` string, nullable — The lead source of the contact.
  - `fax` string, nullable — The fax number of the contact.
  - `description` string, nullable — The description of the contact.
  - `current_balance` number, nullable — The current balance of the contact.
  - `status` string, nullable — The status of the contact.
  - `active` boolean, nullable — The active status of the contact.
  - `websites` Website[]
    - `id` string, nullable — Unique identifier for the website
    - `url` string, required — The website URL
    - `type` 'primary' | 'secondary' | 'work' | 'personal' | 'other', nullable — The type of website
  - `addresses` Address[]
    - `id` string, nullable — Unique identifier for the address.
    - `type` 'primary' | 'secondary' | 'home' | 'office' | 'shipping' | 'billing' | 'work' | 'other', nullable — The type of address.
    - `string` string, nullable — The address string. Some APIs don't provide structured address data.
    - `name` string, nullable — The name of the address.
    - `line1` string, nullable — Line 1 of the address e.g. number, street, suite, apt #, etc.
    - `line2` string, nullable — Line 2 of the address
    - `line3` string, nullable — Line 3 of the address
    - `line4` string, nullable — Line 4 of the address
    - `line5` string, nullable — Line 5 of the address
    - `street_number` string, nullable — Street number
    - `city` string, nullable — Name of city.
    - `state` string, nullable — Name of state
    - `postal_code` string, nullable — Zip code or equivalent.
    - `country` string, nullable — country code according to ISO 3166-1 alpha-2.
    - `latitude` string, nullable — Latitude of the address
    - `longitude` string, nullable — Longitude of the address
    - `county` string, nullable — Address field that holds a sublocality, such as a county
    - `contact_name` string, nullable — Name of the contact person at the address
    - `salutation` string, nullable — Salutation of the contact person at the address
    - `phone_number` string, nullable — Phone number of the address
    - `fax` string, nullable — Fax number of the address
    - `email` string, nullable — Email address of the address
    - `website` string, nullable — Website of the address
    - `notes` string, nullable — Additional notes
    - `row_version` string, nullable — A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object.
  - `social_links` SocialLink[]
    - `id` string, nullable — Unique identifier of the social link
    - `url` string, required — URL of the social link, e.g. https://www.twitter.com/apideck
    - `type` string, nullable — Type of the social link, e.g. twitter
  - `phone_numbers` PhoneNumber[]
    - `id` string, nullable — Unique identifier of the phone number
    - `country_code` string, nullable — The country code of the phone number, e.g. +1
    - `area_code` string, nullable — The area code of the phone number, e.g. 323
    - `number` string, required — The phone number
    - `extension` string, nullable — The extension of the phone number
    - `type` 'primary' | 'secondary' | 'home' | 'work' | 'office' | 'mobile' | 'assistant' | 'fax' | 'direct-dial-in' | 'personal' | 'billing' | 'other', nullable — The type of phone number
  - `emails` Email[]
    - `id` string, nullable — Unique identifier for the email address
    - `email` string, email, nullable, required — Email address
    - `type` 'primary' | 'secondary' | 'work' | 'personal' | 'billing' | 'other', nullable — Email type
  - `email_domain` string, nullable
  - `custom_fields` CustomField[], nullable
    - union
      - object
        - `id` string, nullable, required — Unique identifier for the custom field.
        - `name` string, nullable — Name of the custom field.
        - `description` string, nullable — More information about the custom field
        - `value` union
          - string, nullable
          - number, nullable
          - boolean, nullable
          - object, nullable
          - union[]
            - union
              - …
      - object
        - `id` string, nullable — Unique identifier for the custom field.
        - `name` string, nullable, required — Name of the custom field.
        - `description` string, nullable — More information about the custom field
        - `value` union
          - string, nullable
          - number, nullable
          - boolean, nullable
          - object, nullable
          - union[]
            - union
              - …
  - `tags` string[], nullable
  - `first_call_at` string, date-time, nullable — The first call date of the contact.
  - `first_email_at` string, date-time, nullable — The first email date of the contact.
  - `last_activity_at` string, date-time, nullable — The last activity date of the contact.
  - `custom_mappings` CustomMappings, nullable — When custom mappings are configured on the resource, the result is included here.
  - `updated_at` string, date-time, nullable — The last update date of the contact.
  - `created_at` string, date-time, nullable — The creation date of the contact.
  - `opportunity_ids` string[] — The opportunity ids of the contact.
  - `pass_through` object[] — The pass_through property allows passing service-specific, custom data or structured modifications in request body when creating or updating resources.
    - `service_id` string, required — Identifier for the service to which this pass_through should be applied.
    - `operation_id` string — Optional identifier for a workflow operation to which this pass_through should be applied. This is useful for Unify calls that are making more than one downstream request.
    - `extend_object` object — Simple object allowing any properties for direct extension.
    - `extend_paths` object[] — Array of objects for structured data modifications via paths.
      - `path` string, required — JSONPath string specifying where to apply the value.
      - `value` unknown, required

## Response `200`

Contact updated

- UpdateContactResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `service` string, required — Apideck ID of service provider
  - `resource` string, required — Unified API resource name
  - `operation` string, required — Operation performed
  - `data` UnifiedId, required — A object containing a unique identifier for the resource that was created, updated, or deleted.
    - `id` string, required — The unique identifier of the resource
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

---

[API](https://skmtc.net/apideck-libraries/apis/crm-api.md) · [All operations](https://skmtc.net/apideck-libraries/apis/crm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apideck-libraries/crm-api/versions/171537af6722/schema)