Docs · Getting started

Introduction

The talks API lets you send SMS, email and WhatsApp, run WhatsApp AI agents, and manage contacts, campaigns and credits from your own code.

Base URL

Every request goes to one base URL over HTTPS. Requests and responses are JSON.

Base URL

https://api.talks.africa/v1

AreaWhat it does

SMSSingle and bulk sends, sender IDs, delivery status, scheduling

EmailSingle and bulk sends, templates, unsubscribes, your own sending domain

WhatsAppText, media and location messages from your linked number

AI agentsAgents that reply on WhatsApp and can call your own APIs as tools

ContactsContacts, groups and CSV imports for campaigns

AccountCredits, reports, webhooks, API keys and team

Note: New here? The Quickstart gets you from sign-up to a delivered SMS in about five minutes.

Your first request

curl https://api.talks.africa/v1/credits/balance \
  -H "Authorization: Bearer tk_test_..."

Response

{
  "balance": 48250,
  "reserved": 120,
  "currency": "KES",
  "last_updated": "2026-11-13T19:24:01Z"
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Was this page helpful?