contacts_upsert_contact
Create a new contact or update an existing one in GoHighLevel CRM with detailed fields like name, email, phone, custom data, and duplicate handling.
Instructions
Upsert Contact
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "contacts_upsert_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dnd | No | ||
| city | No | ||
| name | No | ||
| tags | No | 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. | |
| No | |||
| phone | No | ||
| state | No | ||
| gender | No | ||
| source | No | ||
| country | No | ||
| website | No | ||
| address1 | No | ||
| lastName | No | ||
| timezone | No | ||
| firstName | No | ||
| assignedTo | No | User's Id | |
| locationId | No | Defaults to GHL_LOCATION_ID when omitted. | |
| postalCode | No | ||
| companyName | No | ||
| dateOfBirth | No | 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 | |
| dndSettings | No | ||
| customFields | No | ||
| inboundDndSettings | No | ||
| createNewIfDuplicateAllowed | No | Controls whether to create a new contact or update an existing duplicate. **Scenario 1:** If this value is `true` and the location allows duplicate contacts, a new contact will be created immediately without checking for duplicates. **Scenario 2:** If this value is `true` but the location does not a |