Create or update contact
Upsert a contact by phoneNumber within the authorized channel. channelId is verified against channels owned by this API key — passing another workspace channelId is rejected (no cross-tenant write).
Authentication: API key via X-API-Key header (or Authorization: Bearer). Permissions: User API key Rate limit: api_write — 30 requests/min per API user.
Authorizations
Preferred. API key value directly.
Query Parameters
Channel id. Auto-selects the first active channel when omitted.
"ch_123"
Contact phone, digits with optional leading +.
"919876543210"
Display name. Defaults to phoneNumber on create.
Contact email.
"john@acme.com"
Avatar URL.
Map of custom field values, or "k:v,k:v" string. Keys resolve case-insensitively.
Labels to set. Accepts array, comma string, or label alias.
Body
Contact phone, digits with optional leading +.
"919876543210"
Channel id. Auto-selects the first active channel when omitted.
"ch_123"
Display name. Defaults to phoneNumber on create.
Contact email.
"john@acme.com"
Avatar URL.
Map of custom field values, or "k:v,k:v" string. Keys resolve case-insensitively.
Labels to set. Accepts array, comma string, or label alias.