Skip to main content

ResolveContactByChannel looks up (or creates) a contact by channel identifier (phone, email, or WhatsApp handle) within an organisation.

POST 
/internal/v1/crm/contacts:resolve

Internal only — routed via /internal/v1/*. Used by voice inbound and engagement auto-creation to correlate a channel address to a CRM contact.

When create_if_missing = true and no match is found, a new lead-stage contact is created with the provided channel identifier as the primary contact detail.

Errors:

  • NOT_FOUND: contact not found and create_if_missing is false.
  • INVALID_ARGUMENT: channel_type is not "phone", "email", or "whatsapp"; identifier is empty.

Request​

Responses​

A successful response.