Upsert contact
upsert_contactCreate a contact, or update the existing one with the same phone_number.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phone_number": "<phone_number>"
},
"name": "upsert_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name. Defaults to first + last name. | |
| tags | No | Labels that group contacts | |
| No | Email address | ||
| notes | No | Free-text notes | |
| state | No | US state or Canadian province, usually a 2-letter code | |
| fields | No | Up to 20 string values (account id, plan, location...), usable in segments and as {{field:key}} merge fields | |
| opt_in | No | Import only (POST /v1/contacts/import). Stored as consent evidence; never lifts an opt-out. | |
| source | No | Where the contact came from. Defaults to "api". | |
| company | No | Company name | |
| last_name | No | Last name | |
| first_name | No | First name | |
| phone_number | Yes | E.164, US or Canada |