Documentation

Get started

Create an account, collect your API key, and send your first message.

katembe is designed so a developer can go from account creation to a first delivery event in a few minutes.

1. Create an account#

• Create a workspace
• Choose your operating region
• Invite team members for logs and billing

2. Get your API key#

• Generate a test key from the dashboard
• Store it in a secure secret store
• Use test mode until your webhook endpoint is ready.

3. Send your first request#

Use the example below to send your first message. Replace <api_key> with your test key.

curl -X POST https://api.katembe.io/v1/messages \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+258840000000",
    "message": "Hello"
  }'
  

await katembe.messages.create({
  to: "+258840000000",
  message: "Hello"
});
  

client.Messages.Create(ctx, &Message{
  To: "+258840000000",
  Body: "Hello",
})
  

You should receive a 202 Accepted response, indicating the message is queued.

Next steps#

• Add a webhook endpoint for delivery events
• Move from test keys to live keys
• Review rate limits before production traffic