Update a contact

curl --request PATCH \
  --url https://api.hubapi.com/crm/v3/objects/contacts/{contactId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  }
}
'

{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "id": "512",
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Basic

Update a contact

Update an existing contact, identified by ID or email/unique property value. To identify a contact by ID, include the ID in the request URL path. To identify a contact by their email or other unique property, include the email/property value in the request URL path, and add the idProperty query parameter (/crm/v3/objects/contacts/jon@website.com?idProperty=email). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.

PATCH

crm

objects

contacts

{contactId}

Update a contact

curl --request PATCH \
  --url https://api.hubapi.com/crm/v3/objects/contacts/{contactId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  }
}
'

{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "id": "512",
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Supported products

Requires one of the following products or higher.

Marketing Hub -Free

Sales Hub -Free

Service Hub -Free

Content Hub -Free

Data Hub -Free

Required Scopes

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

contactId

string

required

Query Parameters

idProperty

string

The name of a property whose values are unique for this object.

Body

application/json

Represents the input required to create or update a CRM object, containing an object with property names and their corresponding values.

properties

object

required

Key value pairs representing the properties of the object.

Show child attributes

Response

successful operation

A simple public object.

archived

boolean

required

Whether the object is archived.

createdAt

string<date-time>

required

The timestamp when the object was created, in ISO 8601 format.

string

required

The unique ID of the object.

properties

object

required

Key-value pairs representing the properties of the object.

Show child attributes

updatedAt

string<date-time>

required

The timestamp when the object was last updated, in ISO 8601 format.

archivedAt

string<date-time>

The timestamp when the object was archived, in ISO 8601 format.

objectWriteTraceId

string

propertiesWithHistory

object

Key-value pairs representing the properties of the object along with their history.

Show child attributes

url

string

Last modified on December 16, 2025