JawblyJawblyDocs
API reference

Contacts

The people who message your business. Sync them into your CRM or enrich them from your own systems.

Base URLhttps://api.jawbly.com/v1
For agents: llms.txt·OpenAPI
GET List contactsPOST Create or update a contact
GET/contacts

List contacts

Page through your contacts, filterable by tag or search term.

Requires scope contacts:read

Parameters

search
string · query

Match on name or phone number.

tag
string · query

Filter by a contact tag.

curl -X GET "https://api.jawbly.com/v1/contacts" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx"
200 response
{
  "data": [
    {
      "id": "ct_5m…",
      "name": "Sara K.",
      "phone": "+14155550123",
      "tags": [
        "vip"
      ],
      "createdAt": "2026-06-30T09:00:00Z"
    }
  ],
  "nextCursor": null
}
POST/contacts

Create or update a contact

Upsert a contact by phone number, attaching your own metadata and tags.

Requires scope contacts:write

Parameters

phonerequired
string (E.164) · body

Unique key for the contact.

name
string · body

Display name.

metadata
object · body

Arbitrary JSON you can read back later.

curl -X POST "https://api.jawbly.com/v1/contacts" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+14155550123",
    "name": "Sara K.",
    "metadata": {
      "crmId": "A-2201"
    }
  }'
200 response
{
  "id": "ct_5m…",
  "phone": "+14155550123",
  "name": "Sara K.",
  "metadata": {
    "crmId": "A-2201"
  }
}
ConversationsAssistants