Skip to main content
POST
Find Contact

Headers

string
required
Your API key for authentication.

Body Parameters

string
Phone number to search for. At least one identifier is required.
string
Email address to search for. At least one identifier is required.
string
External ID to search for. At least one identifier is required.

Response

Returns the contact with related data, or null if not found.
object
The contact object with identifiers, memories, and entities. Null if no contact found.
string
Unique identifier for the contact.
string
Organization ID the contact belongs to.
string
Contact’s name (if set).
object
Custom metadata associated with the contact.
array
Contact identifiers (phone_number, email, external_id) for this contact.
array
Contact memory objects, one per persona or agent. Each includes summary, facts, recent_messages, open_items, and entities (memory_entity records).
array
Entity-scoped facts (e.g. bookings, orders) for that memory.
null
Error array (null on success).

Docs for agents: llms.txt