Email to SMS

๐Ÿ“˜

Important: API Channel Activation for New Accounts and Sub-Accounts

When you create a new Account or Sub-Account, please be aware that by default, no API channels will be active. To enable API access and manage your Accounts and Sub-Accounts' API credentials and settings, please follow the steps outlined in the "API Keys" page.

Note for Accounts Created Before 6 June 2023: If you have an Account that was created before 6 June 2023, the API channels would have been automatically enabled. However, if you wish to switch to an alternative API or use additional APIs, you will need to create an API Key for the desired API.

Secure Sending - Introduction

This guide contains instructions on how to send an SMS via email, using a registered email address.
There are two methods available: send a single SMS or send bulk/multiple SMSes from one email account.

Email to SMS Prerequisite

  1. Any email client
  2. A SMSPortal account

๐Ÿšง

Security Information

  • For security reasons, only one email address can be authorised to send Email to SMS requests for an SMSPortal account. To configure this please follow the procedure provided in the following โ€œHow to Registerโ€ section.

How to Register

Simply click on "Settings" on the left-hand control panel menu, select the "API Keys" option and follow these easy steps:

To register a new email address (or change the registered email address) you will need to go to the "Actions" section to the right of your screen and click the 3 dots for the "API key for EMAIL" and then select the "Registered Email" option. Enter your email address that you wish to use for this API and click update.

Your Email address will be updated.

How to Send a Single SMS

The following settings are available.

All emails must be addressed to @mymobileapi.com and must contain the subject line, have a from email address and contain a message.

Email FieldDescription
From Your email address
To The To address must start with a mobile number and contain the domain in the address.
E.g. [email protected].

Only one email address will be accepted.
Subject The subject must contain only your account password.
Body The message you wish to send to the mobile phone. This must be in plain text format.
CC Not Used
BCC Not Used

Single SMS - Example Email

1048

How to Send a Bulk SMS

The following settings are available. The items in Bold are required.

All emails must be addressed to [email protected] and must contain the subject line, have a from email address and contain a message.

Email FieldDescription
From Your email address.
To The To address must be [email protected] when sending to multiple
mobile phone numbers from one email. Only one email address will be accepted.
Subject The subject must contain only your account password.
Body Each line item in the email body must consist of the following information:
Phonenumber
Message
* CustomerId (optional)
They must be separated by the tilde โ€œ~โ€ (above the 1 or left of the 1 key on the keyboard)
CC Not Used
BCC Not Used

Bulk SMS - Example Email

Standard Sending - Introduction

This guide contains instructions on how to send an SMS via email using any email client.
There are two methods available: send a single SMS or send bulk/multiple SMSes from any email account.

How to Send a Single SMS

The following settings are available. The items in Bold are mandatory.

All emails must be addressed to @mymobileapi.com and must contain the correctly formatted subject line, have a from email address and contain a message.

Email FieldDescription
From Your email address
To The To address must start with a mobile number and contain the domain in the address.
E.g. [email protected].
Only one email address will be accepted.
Subject All options must be separated by braces.
ata": {
"0-
- Your SMSPortal username
a": {
"0-0"
- Your SMSPortal password
"0-0": โ€“ When set to 1, we will send an acknowledgment via email that the email to SMS request was received, and if it was processed. (optional).
fwdmo=1] โ€“ fwdmo can be set to Subject or
"3-0": "Body ",

When fwdmo is set to ",
replies will be sent to your From email otherwise or when
fwdmo is set to dy
",
"4-0": "*CC replies will be sent to the valid email address
specified (in this case [email protected]) (optional).

An example of a correctly formatted email subject line:
"4-1": "Not Used",
"3-1":
Body The message you wish to send to the mobile phone. This must be in plain text format.
CC Not Used
BCC Not Used

Single SMS - Example Email

Example 1. The subject line contains the minimum required information, un and pw.

Example 2. The subject line contains the minimum required information, un and pw, and the optional parameters, ack and fwdmo.

How to Send a Bulk SMS

The following settings are available. The items in Bold are required.

All emails must be addressed to [email protected] and must contain the correctly formatted subject line, have a from email address and contain a message.

Email FieldDescription
From Your email address.
To The To address must be [email protected] when sending to multiple mobile phone numbers from one email.
Only one email address will be accepted.
Subject All options must be separated by braces.
ata": {
"h-
- Your SMSPortal username
a": {
"h-0"
- Your SMSPortal password
"h-0": โ€“ When set to 1, we will send an acknowledgment via email that the email to SMS request was received, and if it was processed. (optional).
"h-1": "D โ€“ fwdmo can be set to "From* or
"1-0": "
To** ",

When fwdmo is set to ",
"1 replies will be sent to your From email otherwise or when
fwdmo is set to ",
"2-0": "
Subje replies will be sent to the valid email address
specified (in this case [email protected]) (optional).

Example of a correctly formatted email subject line:
"5-0": "BCC ",
"5-1":
Body Each line item in the email body must consist of the following information:
Phonenumber
Message
* CustomerId (optional)
They must be separated by the tilde โ€œ~โ€ (above the 1 or left of the 1 key on the keyboard)
CC Not Used
BCC Not Used

Bulk SMS - Example Email

Example 1. The subject line contains the minimum required information, un and pw, and a line item for each SMS that needs to be sent.

Example 2. The subject line contains the minimum required information, un and pw, and the optional parameters, ack and fwdmo.