Get started

Quickstart: your first sandbox message

Create an API key, connect your WhatsApp recipient through the Sandbox invitation, and send a real message within your configured limits. Check actual provider events for delivery and read receipts.

1. Create an account

Sign up and confirm your e-mail. Every new account gets a sandbox automatically: a test WhatsApp sender that is already connected, so you do not need a Meta Business account to start.

2. Create a sandbox API key

In the console, open Developer → API keys and make sure the environment switch says Sandbox.
Create a key. Copy the secret: it starts with sk_test_ and is shown only once.
Copy your account SID (AC…; every console address carries it as accountSid=AC…) and your sandbox sender SID (WA…, listed under Senders).

shell

export TOUTYE_API_KEY="sk_test_..."
export TOUTYE_ACCOUNT_SID="AC..."
export TOUTYE_SANDBOX_SENDER_SID="WA..."

3. Choose HTTPS or an SDK

Use the curl examples below to call the API directly. The pre-release SDKs are packaged, but public registry publication is pending. The SDK tabs document their interfaces for the upcoming release.

4. Send a message

Use the WhatsApp recipient that confirmed your Sandbox invitation. Delivery and read receipts depend on actual provider events.

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/messages" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "'"$TOUTYE_SANDBOX_SENDER_SID"'",
  "to": "<VERIFIED_RECIPIENT_E164>",
  "type": "text",
  "text": {
    "body": "Hello from the Toutye sandbox"
  }
}'

The answer is 202 Accepted with the new message:

response

{
  "object": "message",
  "sid": "SM4AZTTK56XRT49RC2FGMFK4XYJG",
  "status": "queued",
  "direction": "outbound",
  "from": "WA…",
  "to": { "identifierType": "phone_e164", "value": "<VERIFIED_RECIPIENT_E164>", "contactSid": "CT…" },
  "type": "text",
  "livemode": false,
  …
}

5. Watch it get delivered

Read the message back after a few seconds:

curl

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/messages/SM..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY"

Its status moves queued → sent → delivered → read. In a real integration you do not poll: you receive each change as a message.sent, message.delivered and message.read event. The console shows the same history under Messages.

Next steps

Set up a webhook to receive statuses and replies.
Send to +15550000012: it replies “hello” five seconds after delivery, so you can test inbound messages.
Outside the sandbox, the first message to a customer must be an approved template.
When you are ready, connect your own number in the console and switch to an sk_live_ key.