Skip to main content
POST
/
messages
Send SMS or MMS message
curl --request POST \
  --url 'https://api.wavix.com/v1/messages?appid=' \
  --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": "Sender",
  "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.000Z",
  "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

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
MessageBody1 · object
required
​
callback_url
string

Callback URL for delivery reports.

Example:

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

​
validity
integer<int32>

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

The message successfully submitted.

​
carrier_fees
string

Carrier fees applied to the message

Example:

"0.0"

​
charge
string

Total charge for the message

Example:

"0.0"

​
direction
string

Message direction. Can be either inbound or outbound.

Example:

"outbound"

​
delivered_at
string<date-time>

Timestamp when the message was delivered

Example:

null

​
error_message
string | null

Error message, if any.

Example:

null

​
from
string

Sender of the message

Example:

"Sender"

​
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

Timestamp when the message was submitted

Example:

"2025-09-22T09:07:53.000Z"

​
tag
string

Optional tag for the message

Example:

"campaign_test"

​
to
string

Recipient phone number

Example:

"+15551234567"