Overview

A contact is one person you talk to — on a call, on WhatsApp, or by email. It is identified by a phone number, an email address or a WhatsApp business-scoped user id (BSUID), and optionally belongs to a company through company_id.

Deals, notes and tasks attach to a contact, and the timeline rolls up its activity.

Authentication

Authorization: Bearer cm_your_api_key

The contact object

{
  "id": "4411…",
  "tenant_id": "a0b1…",
  "company_id": "5c6d…",
  "phone": "+919876543210",
  "email": "asha@acme.com",
  "name": "Asha Menon",
  "external_ids": { "shopify": "gid://shopify/Customer/991" },
  "whatsapp_opt_in": true,
  "email_opt_in": false,
  "sms_opt_in": false,
  "consent_source": "checkout_form",
  "consent_updated_at": "2026-08-04T10:00:00Z",
  "whatsapp_bsuid": null,
  "whatsapp_parent_bsuid": null,
  "whatsapp_username": null,
  "metadata": null,
  "created_at": "2026-08-04T10:00:00Z",
  "updated_at": "2026-08-16T09:00:00Z"
}

GET /api/v1/contacts

Newest first.

curl "https://api.callmissed.com/api/v1/contacts?q=acme.com&limit=50" \
  -H "Authorization: Bearer cm_your_api_key"

Returns an array of contact objects.

POST /api/v1/contacts

At least one of phone, email or whatsapp_bsuid is required — 422 a contact requires a phone, an email or a WhatsApp BSUID otherwise.

curl -X POST https://api.callmissed.com/api/v1/contacts \
  -H "Authorization: Bearer cm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "email": "asha@acme.com",
    "name": "Asha Menon",
    "company_id": "5c6d…",
    "whatsapp_opt_in": true,
    "consent_source": "checkout_form"
  }'

Returns 201 with the contact object.

phone, email and whatsapp_bsuid are natural keys. Reusing any of them returns 409 A contact with this phone, email or WhatsApp BSUID already exists. Search with ?q= before creating, or use duplicate detection and merge to clean up after the fact.

GET / PATCH / DELETE /api/v1/contacts/{contact_id}

PATCH accepts the same fields, all optional, with the same bounds. Only the fields you send are changed. Send "company_id": null to un-link the contact from its company.

DELETE returns 204. Deals and conversations that pointed at the contact are kept, with their contact link cleared. The contact's memory is erased with it.

404 Contact not found for an unknown or another tenant's id. 404 Company not found when company_id is not one of your companies.

Contact memory

Your AI agents can remember durable facts about a contact across conversations. These endpoints let you see exactly what is stored and erase any of it.

GET /api/v1/contacts/{contact_id}/memory

Scope contacts:read.

{
  "contact_id": "4411…",
  "facts": [
    {
      "key": "3f9a1c2b7d4e5f60",
      "fact": "Prefers to be contacted in Hindi",
      "confidence": 0.9,
      "source_conversation_id": "c0d1…",
      "created_at": "2026-08-10T09:00:00+00:00",
      "updated_at": "2026-08-16T12:00:00+00:00",
      "seen_count": 3,
      "injected": true
    }
  ],
  "max_facts": 50,
  "updated_at": "2026-08-16T12:00:00Z"
}

DELETE /api/v1/contacts/{contact_id}/memory

Scope contacts:write. Erases every fact about the contact. Returns 204, and is idempotent — erasing a contact with no memory is also 204.

DELETE /api/v1/contacts/{contact_id}/memory/{fact_key}

Scope contacts:write. Erases one fact, addressed by its key (1–64 characters) from the GET response. Returns 204, or 404 Fact not found when the key matches nothing.

Errors

Nothing on this page consumes credits.