upsert_contact
Create or update contacts with email/phone deduplication and idempotent replay; use dry_run to preview changes before writing.
Instructions
Create or update a contact, deduplicated on email/phone. Idempotent on replay. Pass dry_run=true to preview the change without writing.
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": "upsert_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tags to attach. Existing tags are preserved by the platform. | |
| No | Contact email. Email or phone is required. | ||
| phone | No | Contact phone in E.164. Email or phone is required. | |
| dry_run | No | Preview only. Returns the create/update decision and the fields that would change; writes nothing and needs no approval. | |
| last_name | No | ||
| first_name | No | ||
| idempotency_key | No | Explicit replay key. Defaults to a digest of email/phone. |