Contacts are an organization-wide address book shared across every agent. Each contact aggregates a person or company — names, emails, phones, domains, addresses — and is visible to every agent in your org.

Contact profiles can also surface concise, conversation-backed memories, helping agents carry useful context into future interactions. Open a contact in the Inkbox Console to view those memories alongside the relevant conversation history.

The minimum is one non-empty name field: given_name, family_name, company_name, or preferred_name. Emails and phones are validated client-side before the request leaves the SDK.

When an email or call comes in, you usually want to know who it's from before deciding how your agent should respond. contacts.lookup runs a reverse search by exact email, email substring, email domain, exact phone, or phone substring. Exactly one filter is required per call.

Round-trip contacts through the RFC 6350 vCard format to migrate from Apple Contacts, Google Contacts, LinkedIn exports, or any other address book. Bulk import handles up to 1000 cards per request with per-card isolation: one bad card doesn't poison the rest, and the response breaks down created_count / error_count plus per-card errors.

• Contacts API reference
• Memory and correspondence reference
• vCard import/export reference