GoHighLevel Contacts API

Update Contact

PUT/contacts/:contactId

PUT /contacts/:contactId This endpoint takes 1 path parameter and 47 body fields, requires the contacts.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: PUT
Full URL: https://services.leadconnectorhq.com/contacts/:contactId
Scopes: contacts.write
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Notes from the field

For multi-contact field backfills, use `hylo_bulk_execute_ghl_api` with endpoint_name='contacts/update-contact'.
Pass `tags` inline to add tags in the same call as the update (skip add-tags).
For email-only changes, this single call replaces upsert + add-tags.

This endpoint is safe to fan out in parallel, so a batch of records costs roughly one round trip instead of one per record. Hylo's bulk tools do that server-side and retry HighLevel's 429s with back-off.

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`contactId`required	`string`	Example: `ocQHyuzHvysMo5N5VsXc`

Request body

JSON body fields. Nested objects are shown indented under their parent.

Name	Type	Description
`firstName`	`string`	Example: `rosan`
`lastName`	`string`	Example: `Deo`
`name`	`string`	Example: `rosan Deo`
`email`	`string`	Example: `rosan@deos.com`
`phone`	`string`	Example: `+1 888-888-8888`
`address1`	`string`	Example: `3535 1st St N`
`city`	`string`	Example: `Dolomite`
`state`	`string`	Example: `AL`
`postalCode`	`string`	Example: `35061`
`website`	`string`	Example: `https://www.tesla.com`
`timezone`	`string`	Example: `America/Chihuahua`
`dnd`	`boolean`	Example: `true`
`dndSettings`	`object`	—
`└Call`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└Email`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└SMS`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└WhatsApp`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└GMB`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└FB`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`inboundDndSettings`	`object`	—
`└all`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`
`└message`	`string`	—
`tags`	`array`	This field will overwrite all current tags associated with the contact. To update a tags, it is recommended to use the Add Tag or Remove Tag API instead. Example: `nisi sint commodo amet,consequat`
`customFields`	`array`	—
`source`	`string`	Example: `public api`
`dateOfBirth`	`object`	The birth date of the contact. Supported formats: YYYY/MM/DD, MM/DD/YYYY, YYYY-MM-DD, MM-DD-YYYY, YYYY.MM.DD, MM.DD.YYYY, YYYY_MM_DD, MM_DD_YYYY Example: `1990-09-25`
`country`	`string`	Example: `US`
`assignedTo`	`string`	User's Id Example: `y0BeYjuRIlDwsDcOHOJo`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`succeded`	`boolean`	Example: `true`
`contact`	`object`	—
`└id`	`string`	Example: `seD4PfOuKoVMLkEZqohJ`
`└name`	`string`	Example: `rubika deo`
`└locationId`	`string`	Example: `ve9EPM428h8vShlRW1KT`
`└firstName`	`string`	Example: `rubika`
`└lastName`	`string`	Example: `Deo`
`└email`	`string`	Example: `rubika@deos.com`
`└emailLowerCase`	`string`	Example: `rubika@deos.com`
`└timezone`	`string`	Example: `Asia/Calcutta`
`└companyName`	`string`	Example: `DGS VolMAX`
`└phone`	`string`	Example: `+18832327657`
`└dnd`	`boolean`	Example: `true`
`└dndSettings`	`object`	—
`└Call`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└Email`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└SMS`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└WhatsApp`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└GMB`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└FB`	`object`	—
`└status`required	`string`	One of: `active`, `inactive`, `permanent`
`└message`	`string`	—
`└code`	`string`	—
`└type`	`string`	Example: `read`
`└source`	`string`	Example: `public api`
`└assignedTo`	`string`	Example: `ve9EPM428h8vShlRW1KT`
`└address1`	`string`	Example: `3535 1st St N`
`└city`	`string`	Example: `ruDolomitebika`
`└state`	`string`	Example: `AL`
`└country`	`string`	Example: `US`
`└postalCode`	`string`	Example: `35061`
`└website`	`string`	Example: `https://www.tesla.com`
`└tags`	`array`	Example: `nisi sint commodo amet,consequat`
`└dateOfBirth`	`string`	Example: `Date format YYYY-MM-DD`
`└dateAdded`	`string`	Example: `2021-07-02T05:18:26.704Z`
`└dateUpdated`	`string`	Example: `2021-07-02T05:18:26.704Z`

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token, and the sample ID for your own.

curl -X PUT 'https://services.leadconnectorhq.com/contacts/ocQHyuzHvysMo5N5VsXc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "rosan",
    "lastName": "Deo",
    "name": "rosan Deo"
  }'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More contacts endpoints