Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt

Use this file to discover all available pages before exploring further.

The API follows a pure REST contract: the HTTP status code is the success or error signal.

​
Response shape

{ "message_uuid": "...", "wamid": "..." }
A success returns the payload directly, with no envelope. An error always returns { code, message? }.
Switch on code — it is stable and part of the contract. The message is helpful human text and may change without notice.

​
Status families

HTTPMeaningRetry?
2xxSuccess — 200 read, 201 created, 202 accepted (async), 207 multi-status.—
4xxRequest error — auth, validation, or missing resource.No, fix it first.
429Rate limit exceeded.Yes, after the Retry-After.
5xxServer error.Yes, with backoff.

​
Common codes

The body failed schema validation (missing field, wrong type, value out of range). The message indicates which field failed.
The conversation identifier (uuid, whatsapp_user_id, or phone) does not resolve to any conversation in the business.
The 24h window is closed: you cannot send text, media, or quick replies. Send a template to reopen it.
You exceeded 60 requests per minute. Wait the seconds from the Retry-After header. See Rate limits.
Meta rejected the send. The message is persisted as failed. The request can be retried.
Server error while reading data. Retryable with backoff.
Each endpoint documents in the API Reference the full set of codes it can emit.