Update Contact

Update an existing contact by its ID. Only the fields you include in the request body will be changed.

PUT/contacts/:contactId

Scope

contacts.write

Auth Method

Bearer Token

Token Type

Sub-Account / Company

Header Parameters

Parameter	Type	Description
`Authorization`required	string	Bearer {access_token}
`Version`required	string	API Version Possible values: `2021-07-28`
`Content-Type`required	string	application/json

Path Parameters

Parameter	Type	Description
`contactId`required	string	The unique ID of the contact to update.

Body Parameters

Parameter	Type	Description
`firstName`	string	First name.
`lastName`	string	Last name.
`name`	string	Full name.
`email`	string	Email address.
`phone`	string	Phone number in E.164 format.
`address1`	string	Street address.
`city`	string	City.
`state`	string	State or province.
`postalCode`	string	ZIP or postal code.
`country`	string	Country code (ISO 3166-1 alpha-2).
`website`	string	Website URL.
`timezone`	string	IANA timezone.
`dnd`	boolean	Global Do Not Disturb flag.
`dndSettings`	object	Per-channel DND settings.
`tags`	string[]	Tags to assign (replaces existing tags).
`customFields`	object[]	Custom field values to set.
`source`	string	Lead source.
`companyName`	string	Company name.
`dateOfBirth`	string	Birth date (YYYY-MM-DD or similar).
`assignedTo`	string	User ID to assign.

Example RequestcURL

curl -X PUT \
  'https://services.leadconnectorhq.com/contacts/{contactId}' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "Jane",
    "lastName": "Doe",
    "tags": ["vip", "returning"],
    "companyName": "Doe Enterprises"
  }'

Response — 200 OK

Example ResponseJSON

{
  "contact": {
    "id": "ocQHyuzHvuMOe5N5jjXF",
    "firstName": "Jane",
    "lastName": "Doe",
    "name": "Jane Doe",
    "email": "[email protected]",
    "phone": "+15551234567",
    "locationId": "ve9EPM428h8vShlRW1KT",
    "tags": ["vip", "returning"],
    "companyName": "Doe Enterprises",
    "dateUpdated": "2024-06-16T14:00:00.000Z"
  }
}

Country Field

Please use only accepted ISO 3166-1 alpha-2 country codes. See the country list for valid values.

← Create Contact Delete Contact →