SMS

Send With SES integrates with your AWS SNS account to send SMS (Text Messages). You can send SMS manually or via the API. There are three types of SMS you can send and each type has a predefined template.

Type of SMS	How to send
Transactional	Manually or via API
Marketing	Manually or via API
One Time Passwords (OTP)	ONLY via API

---

Manual SMS - (Transactional OR Marketing):

To send an SMS manually, select one or more contacts or filter contacts using the options in the left panel and click "Send Button" at top. You will be shown a popup where you can compose your SMS.

NOTEs:

• Sender ID is optional. Enter only if you have one.

• Origination number is required only if you are sending to USA mobile numbers.

---

API SMS - (Transactional OR Marketing):

See the request/response details below.

API Request

URL: https://api.sendwithses.com/send-sms

{
      "method": "POST",
      "url": "https://api.sendwithses.com/send-sms",
      "headers": {"template-key": "**************************4lVm"},
      "body": {
          "sender_id": "ABCDEF",
          "origination_number": "[phone]",
          "mobile": "[phone]",
          "message": "Hello John."
       }
}

IMPORTANT:

• All API calls MUST include the Template Key. Template Key is unique to Transactional SMS and Marketing SMS.

• 'Origination Number' is required only when sending to USA mobile numbers.

• All mobile numbers MUST be in E.164 format.

API Response

Success Response:

{
      "success": true,
      "message": "SMS Sent"
}

Failed Response:

{
      "success": false,
      "message": "message details",
      "error": "error details"
}

---

OTP SMS - (Can be sent via API ONLY):

OTP SMS is used to send one time codes intended for Two-Factor Authentication (2FA) or other high value transactions within your website or mobile app. OTP SMS has a template that allows you to customize fields like App Name, OTP Size, and OTP Expiry Time.

The OTP SMS includes two parts, Send API and Verify API.

Send API

Send API is used to trigger the SMS containing one time code to the end user.

URL: https://api.sendwithses.com/send-otp

Request:

{
      "method": "POST",
      "url": "https://api.sendwithses.com/send-otp",
      "headers": {"template-key": "****************************elA2"},
      "body": {
          "sender_id": "ABCDEF"
          "origination_number": "[phone]"
          "mobile": "[phone]",
       }
}

Success Response:

{
      "success": true,
      "message": "OTP Sent"
}

Failed Response:

{
      "success": false,
      "message": "message details",
      "error": "error details"
}

IMPORTANT:

• All API calls MUST include the Template Key. Template Key is unique to OTP SMS.

• 'Origination Number' is required only when sending to USA mobile numbers.

• All mobile numbers MUST STRICTLY be in E.164 format.

Verify API

Verify API is used to match the one time code received from end user with the code generated during the Send API call.

URL: https://api.sendwithses.com/verify-otp

Request:

{
      "method": "POST",
      "url": "https://api.sendwithses.com/verify-otp",
      "headers": {"template-key": "***********************elA2"},
      "body": {
          "mobile": "[phone]"
          "otp": "123456",
       }
}

Success Response:

{
      "success": true,
      "message": "OTP Verified"
}

Failed Response:

{
      "success": false,
      "message": "message details",
      "error": "error details"
}

IMPORTANT:

• All API calls MUST include the Template Key. Template Key is unique to OTP SMS.

• 'Origination Number' is required only when sending to USA mobile numbers.

• All mobile numbers MUST STRICTLY be in E.164 format.