POST api/v2/sms/messages

This method sends either of the following type of messages: 1) Advanced Messages (Secure or long message) 2) Standard Messages 3) Recurring Messages

Request Information

URI Parameters

None.

Body Parameters

The details of the message to be sent.

MessageV2

Name	Description	Type	Additional information
Contacts	List of all the contacts to send the message to.	ContactsIncQuick	Required
Content	The actual message to be sent.	string	None.
Options	The options for the message.	MessageOptionsV2	Required
Template	The template of the message to be sent out. If present, it will overwrite whatever is in the content parameter.	TemplateInfo	None.
Type	Determines the type of message. Standard, advanced or recurring.	MessageRequestType	Required

Request Formats

application/json, text/json

Sample:

{
  "Contacts": {
    "ContactID": {
      "sample string 1": 0,
      "sample string 2": 0
    },
    "GroupID": {
      "sample string 1": 0,
      "sample string 2": 0
    },
    "QuickRecipients": {
      "sample string 1": 0,
      "sample string 2": 0
    }
  },
  "Content": "sample string 1",
  "Options": {
    "DateToSend": "2025-10-31T06:13:44.8395496+00:00",
    "DeliveryReceipt": true,
    "DstPort": 1,
    "DeliverToValidatedOnly": true,
    "RecurringOptions": {
      "OccurrencesEnd": 1,
      "PatternScheduleDays": 0,
      "Range": 0,
      "RecDateToSend": "2025-10-31T06:13:44.8405503+00:00"
    },
    "EmailReadReceipt": true,
    "Reference": "sample string 1",
    "ExpiryDate": "2025-10-31T06:13:44.8405503+00:00",
    "Repeat": {
      "Frequency": 1,
      "Repetitions": 2
    },
    "Reads": 1,
    "EmailOptions": {
      "FromAddress": "sample string 1",
      "FromName": "sample string 2",
      "Subject": "sample string 3",
      "ReplyTo": "sample string 4"
    },
    "ResponseAlert": 0,
    "SmsReadReceipt": true,
    "ResponseLimit": 2,
    "Sender": "sample string 3",
    "SecureMessage": true,
    "SrcPort": 1
  },
  "Template": {
    "ID": "768d895b-adb3-4e33-81b1-05423b28f0bc",
    "PlaceHolders": {
      "1": "sample string 2",
      "3": "sample string 4"
    }
  },
  "Type": 0
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResponseOfSMSTransactionV2

Name	Description	Type	Additional information
Error		Error	None.
ResponseData		ResponseDataOfSMSTransactionV2	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "IDs": {
        "AdvancedMessageID": "aa7ef3ff-645f-419c-8268-0f52e96fcfc2",
        "StandardMessageIDs": {
          "sample string 1": [
            "sample string 1",
            "sample string 2"
          ],
          "sample string 2": [
            "sample string 1",
            "sample string 2"
          ]
        }
      },
      "NoOfContacts": "sample string 1",
      "NoOfQuickRecipients": "sample string 2",
      "NoOfSMS": "sample string 3",
      "NoOfEmails": "sample string 4",
      "PreTransaction": "sample string 5",
      "PostTransaction": "sample string 6",
      "CreditsUsed": "sample string 7",
      "MessageText": "sample string 8"
    }
  }
}