Get started

Quickstart

Send your first message with Ujumbe Connect in under five minutes. The quickstart guide covers signing up, getting an API key, and sending across SMS, WhatsApp, RCS and more.

1. Get an API key

Create a workspace and copy your sandbox key from Developers → API keys.

2. Send a message

import { Ujumbe } from "@ujumbe/sdk";

const client = new Ujumbe(process.env.UJUMBE_API_KEY);

await client.messages.create({
  channel: "whatsapp",
  to:      "+254712994110",
  template: "order_shipped",
  variables: { order: "98213", eta: "today 6pm" },
});

3. Receive a delivery receipt

Configure a webhook URL in Developers → Webhooks. We'll POST a signed JSON payload for every status change.

POST https://your.app/hooks/dlr X-Ujumbe-Signature: t=1715617200,v1=fbd3... { "id": "msg_01HXV1...", "channel": "sms", "status": "delivered", "to": "+254712994110", "ts": "2025-05-13T12:34:56Z" }

Next steps

Set up an SMPP bind for high-throughput SMS
Submit a WhatsApp template for review
Build your first campaign in the dashboard