Quickstart

This guide takes you from zero to your first WhatsApp message sent through the API.

Get your API key

The API key is issued from the dashboard, under Settings → API. It has the sk_1to1_ prefix.

The API key grants full access to your business’s conversations. Treat it as a secret — never put it in client-side code or commit it to a repository.

Identify your business

Every endpoint hangs off a base URL that includes your business’s {slug}:

https://app.1to1.ai/api/v1/public/{slug}

The {slug} is also in the API settings. The key and the slug must belong to the same business.

Send your first message

A POST to the text endpoint, with the conversation identified by phone:

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \
  -H "Authorization: Bearer sk_1to1_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "body": "Hi 👋, how can I help you?"
  }'

const res = await fetch(
  "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer sk_1to1_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      conversation: { phone: "+5215512345678" },
      body: "Hi 👋, how can I help you?",
    }),
  },
);

import requests

requests.post(
    "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text",
    headers={"Authorization": "Bearer sk_1to1_your_api_key"},
    json={
        "conversation": {"phone": "+5215512345678"},
        "body": "Hi 👋, how can I help you?",
    },
)

Handle the response

A 201 response confirms the send:

{ "message_uuid": "...", "wamid": "..." }

Errors return { code, message } with a 4xx or 5xx status. Both fields are guaranteed. Switch on code (stable), never on message (human text, may be refined between API versions):

{ "code": "WINDOW_CLOSED", "message": "..." }

Rate limit: two independent buckets of 60 requests/min per API key — one general (reads, tags, mailbox, notes, files) and one for messages (text, quick-reply, template). When exceeded you get a 429 with the Retry-After header. See Rate limits.

Introduction

Concepts

Guides

API Reference

Next steps

Conversations

Messages

​Next steps

Conversations

Messages

Next steps