Get started: Overview

Go from sandbox to production—fast and safely. Enterprise-ready defaults for retries, idempotency, scoped keys, and observable delivery.

Getting started

The shortest safe path to your first integration

This guide is designed for teams shipping production workloads across multiple countries and channels. Start in sandbox, validate request flows, then move to production with governance, monitoring, and controlled rollout.

Start: Authentication Talk to Solutions Engineering

1) Authenticate

Create a project and generate an API key with the least privilege needed.

2) Make your first API call

Send a message and validate response + delivery reporting.

3) Move to production

Enable governance controls, monitoring, and safe rollout practices.

Enterprise suggestions (recommended)

These defaults improve reliability, reduce duplicate sends, and help operations teams troubleshoot faster.

Use idempotency keys

Prevent duplicate sends during retries and network timeouts.

Implement retries with backoff

Handle transient failures without creating traffic spikes.

Scope access per environment

Separate sandbox vs production keys and rotate regularly.

Monitor delivery + errors

Track delivery rates and latency; alert on anomalies.

Authentication First API call Sandbox vs Production

Tutorial home Next: Authentication

Live Examples

cURL

bash

1# 1) Authenticate
2# Use your Sandbox API key from the Console
3
4export AFRIROUTE_API_KEY="YOUR_API_KEY"
5
6# 2) Make a first request (example)
7curl -X POST BASE_URL/api/v1/channels/sms/otp   -H "X-API-Key: $AFRIROUTE_API_KEY"   -H "Content-Type: application/json"   -d '{
8    "to": "+2519XXXXXXX",
9		"country": "ET",
10		"template": "Your verification code is 123456"
11  }'

Demo-mode examples are safe to run and show request shapes.

Get started: Overview

Go from sandbox to production—fast and safely. Enterprise-ready defaults for retries, idempotency, scoped keys, and observable delivery.

Getting started

The shortest safe path to your first integration

Start: Authentication Talk to Solutions Engineering

1) Authenticate

Create a project and generate an API key with the least privilege needed.

2) Make your first API call

Send a message and validate response + delivery reporting.

3) Move to production

Enable governance controls, monitoring, and safe rollout practices.

Enterprise suggestions (recommended)

These defaults improve reliability, reduce duplicate sends, and help operations teams troubleshoot faster.

Use idempotency keys

Prevent duplicate sends during retries and network timeouts.

Implement retries with backoff

Handle transient failures without creating traffic spikes.

Scope access per environment

Separate sandbox vs production keys and rotate regularly.

Monitor delivery + errors

Track delivery rates and latency; alert on anomalies.

Authentication First API call Sandbox vs Production

Tutorial home Next: Authentication

Live Examples

cURL

bash

1# 1) Authenticate
2# Use your Sandbox API key from the Console
3
4export AFRIROUTE_API_KEY="YOUR_API_KEY"
5
6# 2) Make a first request (example)
7curl -X POST BASE_URL/api/v1/channels/sms/otp   -H "X-API-Key: $AFRIROUTE_API_KEY"   -H "Content-Type: application/json"   -d '{
8    "to": "+2519XXXXXXX",
9		"country": "ET",
10		"template": "Your verification code is 123456"
11  }'

Demo-mode examples are safe to run and show request shapes.