# Tawked

> Tawked developer documentation: OTP verification and WhatsApp messages for Saudi mobile numbers, in a few HTTP calls.

- [Tawked developer docs](https://docs.tawked.com/index.md): OTP verification and WhatsApp messages for Saudi mobile numbers, in a few HTTP calls.
- [Quickstart](https://docs.tawked.com/quickstart.md): Send a code and verify it, end to end, with a sandbox key.
- [Authentication](https://docs.tawked.com/authentication.md): API keys, their modes and scopes, and the hardening options.
- [Sandbox](https://docs.tawked.com/sandbox.md): Test against the real API, with real messages, before your application is approved.
- [Destinations and messages](https://docs.tawked.com/destinations.md): Accepted number formats, message language, and autofill-ready SMS.
- [Reliability and limits](https://docs.tawked.com/reliability.md): Idempotency keys, rate limits, per-destination caps, and the protection guard.
- [Webhooks](https://docs.tawked.com/webhooks.md): Signed events when a verification is verified, fails or expires, and when a WhatsApp message changes status.
- [Errors](https://docs.tawked.com/errors.md): Every error code the API returns, with its HTTP status and what to do about it.
- [WhatsApp overview](https://docs.tawked.com/whatsapp/overview.md): Send approved WhatsApp templates through your own number, with the application's live key.
- [Sending messages](https://docs.tawked.com/whatsapp/messages.md): Send a template, read its status, and receive status webhooks.
- [AI agents and coding assistants](https://docs.tawked.com/agents.md): Give Claude Code, Codex, Cursor or any agent the Tawked reference: MCP server, Markdown pages, llms.txt, skill.md and the OpenAPI document.
- [Start a verification](https://docs.tawked.com/api-reference/verify/start-a-verification.md): Sends a one-time code to a destination and returns an id to check it against.
- [Check a code](https://docs.tawked.com/api-reference/verify/check-a-code.md): Verifies the code the end user typed against the id from /verify/start.
- [Get a verification](https://docs.tawked.com/api-reference/verify/get-a-verification.md): Reads the current state of a verification — status, channel, destination, and how many attempts and resends remain — without consuming an attempt.
- [Resend a code](https://docs.tawked.com/api-reference/verify/resend-a-code.md): Sends a new code on the same id: the previous code stops working, attempts and the expiry reset, and the send is charged and rate-limited like any other — up to 3 resends per verification.
- [Cancel a verification](https://docs.tawked.com/api-reference/verify/cancel-a-verification.md): Cancels a pending verification. A later `check` on it answers `{ "verified": false, "status": "canceled" }`.
- [Send a template message](https://docs.tawked.com/api-reference/whatsapp/send-a-template-message.md): Sends an approved template to a Saudi mobile through the number attached to the application, and answers `202` with an id to track it. The fee, if any, is for the send; a failed send refunds it.
- [Get a message](https://docs.tawked.com/api-reference/whatsapp/get-a-message.md): Reads a message's current status and timestamps. Statuses arrive from Meta within about a minute; `error` is set when the message failed. A message belongs to the key's application; any other id answers `404`.
- [List templates](https://docs.tawked.com/api-reference/whatsapp/list-templates.md): Lists the templates of the number's WhatsApp Business Account as Meta holds them, with the placeholders each one expects, so your code can discover what to send without WhatsApp Manager. Cached for 5 minutes.

## OpenAPI Specs

- [openapi](https://tawked.com/openapi.json)