Quickstart
From zero to a delivered SMS in three steps. Grab an API token from the dashboard, then send your first message over the REST API.
Don't have a token yet? Create an account and copy one from your profile. See Authentication.
Get your API token
Sign up at pindo.io, then open your profile icon → Security to view and copy your token.
Profile Security
Send your first SMS
Post your token as a bearer credential, a recipient in international format, your message, and a sender name. Pick your language: it sticks across the docs.
# Send a single sms
curl -X POST \
https://api.pindo.io/v1/sms/ \
-H 'Accept: */*' \
-H 'Authorization: Bearer your-token' \
-H 'Content-Type: application/json' \
-d '{
"to" : "+250781234567",
"text" : "Hello from Pindo",
"sender" : "PindoTest"
}'
# Send bulk sms
curl -X POST \
https://api.pindo.io/v1/sms/bulk \
-H 'Accept: */*' \
-H 'Authorization: Bearer your-token' \
-H 'Content-Type: application/json' \
-d '{
"recipients" : [{"phonenumber": "+250781234567", "name": "Remy Muhire"}],
"text" : "Hello @contact.name, Welcome to Pindo",
"sender" : "PindoTest"
}'Check the response
A 201 response means it's on the way, with a cost breakdown and your remaining balance.
{
"bonus": 0.0,
"discount": 0.4,
"item_count": 1,
"item_price": 0.006,
"remaining_balance": 71421.953,
"self_url": "http://api.pindo.io/v1/sms/out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
"sms_id": "out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
"status": "sent",
"to": "+250789385878",
"total_cost": 0.006
}Where to next
You've sent your first message. Now dig into bulk sends, replies, and 2FA.