# Overview

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json

The InboxWA API is the same surface the web app runs on. Whatever your team can see or do in InboxWA, a key can see or do, under the same permissions. Only the calls documented in this reference are supported for integrations; see "What is supported" below.

Requests and responses are JSON over HTTPS. The base address is `https://inboxwa.online`. Send phone numbers with the country code, digits only; a leading + and spaces are accepted, so `919876543210` and `+91 98765 43210` are the same number. A 10-digit number with no country code is taken to be an Indian number and has 91 put in front of it, so always include the country code for any other country. Timestamps in the Reporting API and in webhooks are ISO 8601 in UTC.

- **The whole product.** Chats, contacts, leads, messaging, templates, automation, the AI agent, credits, team, SLA, integrations and more are reachable with a key.
- **Messaging and contacts.** Send a message or a broadcast, and create and update contacts, their tags, attributes and consent. These are part of the core API, included in Growth and Scale. Reading contacts and chats with a key is part of the full API (Scale plan).
- **Plans.** Starter has no API and no webhooks. Growth has the core API and five webhook events. Scale has every call, the Reporting API and all webhook events. See [Plans and API access](https://inboxwa.online/docs/api/guide/plans.md).
- **The reporting API.** Purpose-built calls for unread, unanswered, seen-by, receipts, replies and first-response times under `/api/reporting/v1`. Requires the Scale plan.
- **Push as well as pull.** Signed webhooks, and an MCP endpoint for your own AI tools.

> **What is supported** The calls documented in this reference are the supported API. They keep their shape, and any change to one is listed in the changelog. Every other route accepts the same key but is the web app’s internal interface: it is not documented, it is unsupported for integrations, and it can change or disappear without notice. `GET /api/docs/routes` lists those routes for reference only. Do not build an integration on them.

> **For AI assistants and other tools** This documentation is also published without JavaScript: the whole reference as [Markdown](https://inboxwa.online/docs/api.md), the [OpenAPI document](https://inboxwa.online/openapi.json), and an index for AI assistants at [/llms.txt](https://inboxwa.online/llms.txt). Every guide and every call has its own Markdown page too, for example [API keys](https://inboxwa.online/docs/api/guide/keys.md).