Docs

Quickstart

Send your first SMS in four steps. Use a test key while you build: it behaves like a live key without sending real messages or spending credits.

  1. Create an account

    Sign up in the dashboard, or with POST /v1/auth/signup.

  2. Copy your API keys

    Open Developers → API keys in the dashboard, or call GET /v1/developer/keys. You get a tk_test_ key and a tk_live_ key.

  3. Store the key safely

    Keep it in an environment variable on your server. Never put it in a mobile app or a website.

    export TALKS_KEY="tk_test_..."

  4. Send an SMS

    Call POST /v1/sms/send with a recipient and a message.

    curl https://api.talks.africa/v1/sms/send \
  -H "Authorization: Bearer $TALKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+254712345678", "message": "Hello from talks"}'

Next steps

ErrorsHandle failures the right way and know what to retry
WebhooksGet delivery updates pushed to you instead of polling
Sending messagesPhone formats, SMS segments and scheduling
Was this page helpful?
Powered by StdioX Labs