Skip to main content
This quickstart is for sandbox accounts. New accounts start in the sandbox, so you’ll send an SMS to your own verified number and receive it on your phone. The same request works for any recipient after you go live, with no code changes.
This tutorial walks you through sending your first SMS with the Wavix API.

​
Prerequisites

Prefer not to write code? Connect an AI client to the Wavix MCP server and send the same test message in natural language.
1

Find your sender number

When your sandbox becomes active, Wavix provisions a free phone number to your account. You’ll use it as the sender.
  1. Sign in to the Wavix portal.
  2. Go to Numbers & trunks.
  3. Copy the number listed under My numbers, in E.164 format.
If you’ve already gone live, use any registered Sender ID as the sender instead.
2

Send the message

Send a POST request to the messages endpoint. Replace the API key, the sender number (from), and the destination (to).
In the sandbox, to must be your verified number. The platform rejects any other destination. For the full rules, see Sandbox.
curl --request POST \
  --url https://api.wavix.com/v3/messages \
  --header 'Authorization: Bearer your_api_key_here' \
  --header 'Content-Type: application/json' \
  --data '{
    "from": "447441477410",
    "to": "12015551234",
    "message_body": {
      "text": "Hello from Wavix."
    }
  }'
If successful, the service returns the HTTP 201 Created status code and the message details, including a message_id and a status of accepted. Your verified number should receive the message shortly.
3

Check delivery

Use the message_id from the response to check the delivery status:
GET https://api.wavix.com/v3/messages/{message_id}
Authorization: Bearer your_api_key_here
The status field moves from accepted to sent to delivered. For what each status means, see Send SMS messages.You can also check delivery in the Wavix portal. In the top menu, select History → SMS history, then open the Outbound tab to see your sent messages and their status.

​
Next steps