Skip to main content
POST
/
messages
Send SMS or MMS message
curl --request POST \
  --url https://api.wavix.com/v3/messages \
  --header 'Content-Type: application/json' \
  --data '{
  "from": "Wavix",
  "to": "+447537151866",
  "message_body": {
    "text": "Hi there, this is a message from Wavix",
    "media": null
  },
  "callback_url": "https://you-site.com/webhook",
  "validity": 3600,
  "tag": "Fall sale"
}'
{
  "carrier_fees": "0.0",
  "charge": "0.0",
  "delivered_at": null,
  "error_message": null,
  "from": "TestSender",
  "mcc": "310",
  "mnc": "260",
  "message_body": {
    "text": "This is a test MMS message with multiple media attachments.",
    "media": [
      "https://api.examples.com/v3/messages/attachments/abc123/file1.mp3",
      "https://api.examples.com/v3/messages/attachments/abc123/file2.mp3",
      "https://api.examples.com/v3/messages/attachments/abc123/file3.mp3"
    ]
  },
  "message_id": "abc123de-4567-890f-gh12-ijklmnop3456",
  "message_type": "mms",
  "segments": 1,
  "sent_at": null,
  "status": "accepted",
  "submitted_at": "2025-09-22T09:07:53",
  "tag": "campaign_test",
  "to": "+15551234567"
}

Authorizations

​
appid
string
query
required

An API key to authorize your request

Body

application/json

An SMS or MMS message to be sent

​
from
string
required

Sender ID registered on your account. Can be numeric or alphanumeric.

Example:

"Wavix"

​
to
string
required

Destination phone number

Example:

"447537151866"

​
message_body
object
required
​
callback_url
string

Callback URL for delivery reports.

Example:

"https://you-site.com/webhook"

​
validity
integer

Validity period of the message, in seconds. The platform stops sending the message after the validity period expires.

Example:

3600

​
tag
string

An optional field normally used to identify a group of SMS, e.g. messages associated with a certain campaign.

Example:

"Fall sale"

Response

Successful message submission response

​
carrier_fees
string

Carrier fees applied to the message

Example:

"0.0"

​
charge
string

Total charge for the message

Example:

"0.0"

​
delivered_at
string<date-time>

Timestamp when the message was delivered

Example:

null

​
error_message
string

Error message if the message failed

Example:

null

​
from
string

Sender of the message

Example:

"TestSender"

​
mcc
string

Mobile country code

Example:

"310"

​
mnc
string

Mobile network code

Example:

"260"

​
message_body
object
​
message_id
string

Unique identifier of the message

Example:

"abc123de-4567-890f-gh12-ijklmnop3456"

​
message_type
string

Type of the message

Example:

"mms"

​
segments
integer

Number of message segments

Example:

1

​
sent_at
string<date-time>

Timestamp when the message was sent

Example:

null

​
status
string

Current status of the message

Example:

"accepted"

​
submitted_at
string<date-time>

Timestamp when the message was submitted

Example:

"2025-09-22T09:07:53"

​
tag
string

Optional tag for the message

Example:

"campaign_test"

​
to
string

Recipient phone number

Example:

"+15551234567"

⌘I