# Jawbly

> Jawbly lets any business build a configurable AI assistant that answers customers, books, captures leads and takes orders on WhatsApp. This file helps AI tools understand how to integrate with Jawbly.

- API base URL: https://api.jawbly.com/v1
- Auth: Bearer token (per-business scoped API keys, created in the dashboard).

## Integrations

- REST API: A clean, tenant-scoped REST API over your messages, contacts, catalog, records and analytics. Bearer-auth with your own scoped API keys. (https://docs.jawbly.com/api)
- MCP Server: A Model Context Protocol server that exposes Jawbly as tools any MCP client can call: Claude Code, Claude Desktop, Cursor and more. (https://docs.jawbly.com/mcp)
- CLI: A command-line tool to manage assistants, sync catalog, tail conversations and export records. Scriptable and CI-friendly. (https://docs.jawbly.com/cli)
- Webhooks: Subscribe to events like message.received or record.created and react in your own systems the moment they happen. (https://docs.jawbly.com/webhooks)
- Node SDK: A typed JavaScript/TypeScript client, @jawbly/sdk, with full types generated from the same catalog that powers this portal.
- Python SDK: An idiomatic Python client, jawbly on PyPI, for backends, notebooks and data pipelines.
- Claude Code: Add the Jawbly MCP server to Claude Code with a single command and let the agent manage your assistant for you. (https://docs.jawbly.com/mcp#claude-code)
- Zapier: Trigger Zaps from Jawbly events and push data back. Connect thousands of apps without writing code.
- Make: Build visual automation scenarios around your conversations, orders and leads.
- n8n: Wire Jawbly into self-hosted n8n workflows using the REST API and webhooks.

## API endpoints

- POST /messages: Send a message. Scope: messages:write.
- GET /conversations/{conversationId}/messages: List messages. Scope: messages:read.
- GET /conversations: List conversations. Scope: conversations:read.
- POST /conversations/{conversationId}/handoff: Hand off to a human. Scope: conversations:write.
- GET /contacts: List contacts. Scope: contacts:read.
- POST /contacts: Create or update a contact. Scope: contacts:write.
- GET /assistants/{assistantId}: Get an assistant. Scope: assistants:read.
- GET /skills: List skills. Scope: skills:read.
- PUT /skills/{skillId}: Upsert a skill. Scope: skills:write.
- POST /catalog/{collection}/items: Upsert catalog items. Scope: catalog:write.
- GET /records/{collection}: List records. Scope: records:read.
- GET /analytics/summary: Get analytics summary. Scope: analytics:read.
- GET /usage/wallet: Get wallet balance. Scope: usage:read.

## Webhook events

- message.received: A customer sent a message to your number.
- message.sent: Your assistant (or your API call) sent a message.
- conversation.handoff: A conversation was handed off to a human.
- record.created: A record was captured (order, lead or booking).
- contact.created: A new contact was seen for the first time.

## Full docs

- Developer portal: https://docs.jawbly.com
- API reference: https://docs.jawbly.com/api
- Machine-readable API docs (Markdown): use the "Copy for AI" action in the portal