Sign in

v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
SMS and MMS

Send a message

Sends an SMS or MMS message. MMS is supported for U.S. numbers only. Track delivery using the returned message_id and the message status callback. Rate limit: 20 messages per phone number in 24 hours.

post/v3/messages

Request body

fromstring required

Sender ID. Numeric or alphanumeric.

tostring required

Recipient phone number.

callback_urlstring

Callback URL for delivery reports.

validityinteger

Message validity period in seconds. Delivery attempts stop after this period expires.

tagstring

Tag to group messages, such as for a specific campaign.

Example request

{
  "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"
}

Response

Returns the submitted message with its message_id and initial status.

carrier_feesstring nullable

Mobile carrier fees in USD.

chargestring

Total charge for the message in USD.

directionstring

Message direction. Possible values are outbound, inbound.

delivered_atstring date-time nullable

Date and time the message was delivered in ISO 8601 format.

error_messagestring nullable

Error message.

fromstring

Sender ID.

mccstring nullable

Mobile country code.

mncstring nullable

Mobile network code.

message_idstring

Message ID.

message_typestring

Message type.

segmentsinteger

Number of SMS segments. Always 1 for MMS.

sent_atstring date-time nullable

Date and time the message was sent in ISO 8601 format.

statusstring

Message status.

submitted_atstring

Date and time the message was submitted in ISO 8601 format.

tagstring nullable

Message tag.

tostring

Recipient phone number.

Example response

{
  "carrier_fees": "0.0",
  "charge": "0.0",
  "direction": "outbound",
  "delivered_at": "2024-05-28T12:34:56Z",
  "from": "Sender ID.",
  "mcc": "310",
  "mnc": "260",
  "message_body": {
    "text": "Hi there, this is a sample message",
    "media": [
      "https://you-site.com/media"
    ]
  },
  "message_id": "abc123de-4567-890f-gh12-ijklmnop3456",
  "message_type": "mms",
  "segments": 1,
  "sent_at": "2024-05-28T12:34:54Z",
  "status": "accepted",
  "submitted_at": "2025-09-22T09:07:53Z",
  "tag": "campaign_test",
  "to": "+15551234567"
}