Sign in
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"
}

Changes

Changed in 5 of the 50 revisions of this API.915

  • 76b9bb35619f22See the full diff
    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the // response's property format changed from uri to no format for status

      response-property-type-changed

    • ○

      the response property / became required for the status

      response-property-became-required

    • ○

      the response property / became required for the status

      response-property-became-required

    This revision also has 42 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 33be779051201See the full diff
    • ○

      the endpoint scheme security bearerAuth was added to the API

      api-security-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ce71f60fb3566See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

  • 2e48fd9894e1111See the full diff
    • ▲

      added to the request body allOf list

      request-body-all-of-added

    • ●

      removed from the request body allOf list

      request-body-all-of-removed

    • ○

      api operation id SendSMSorMMSmessage removed and replaced with sms_and_mms_messages_send

      api-operation-id-removed

    This revision also has 163 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • fabaadf195a91See the full diff
    • ○

      endpoint added

      endpoint-added