Skip to main content
1

Create an API key

Sign in at app.telaven.com, open Settings → API keys and select Create API key. Copy the key; it starts with tlv_ and is shown only once.Keep it in an environment variable on your server:
2

Check the key works

GET /balance is a safe first call. It confirms the key and shows how many SMS your wallet covers.
3

Send an SMS

4

Read the response

status: "sent" means the network accepted the message. Delivery is confirmed later: poll GET /sms/messages/{id} with the recipient id, or subscribe to the sms.delivered and sms.failed webhooks.

Next steps

Authentication

Scopes, IP allowlists and keeping keys safe.

SMS campaigns

Send to lists and tags, now or on a schedule.

Webhooks

Delivery reports and replies, pushed to you.