Quickstart

Send your first WhatsApp message

Get from zero to a delivered WhatsApp message in under five minutes.

1. Get an API key

2. Choose a template

All first messages to a contact must use a Meta-approved HSM template. Approve one from Templates → New.

3. Send your first message

Make a POST to /v1/messages with your key in the Authorization header.

4. Listen for delivery events

Configure a webhook URL to receive delivered / read / replied events as Meta forwards them.

cURL

curl -X POST https://api.sendystack.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+254712345678",
    "type": "template",
    "template": {
      "name": "welcome_onboarding",
      "language": "en_US",
      "bodyParams": ["Dominic"]
    }
  }'

Node.js

import fetch from "node-fetch";

await fetch("https://api.sendystack.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+254712345678",
    type: "template",
    template: { name: "welcome_onboarding", language: "en_US", bodyParams: ["Dominic"] },
  }),
});

Successful response

{
  "status": "queued",
  "message_id": "msg_01H…",
  "meta_message_id": "wamid.HBg…",
  "tenant_id": "ten_…",
  "api_key_id": "key_…"
}