Structure of the email
Please use the following format for your emails to our gateway. If your application can not be adapted to send the emails according to this format, please contact us – our Email2SMS Api is flexible customizable!
Recipient
To send an SMS via the Email2SMS Gateway, send an email to recipient@gateway.sms77.io
, replacing recipient with the recipient number or the contact name from your adress book.
If you want to send an SMS e.g. to the number 01761234567890
, the recipient must be replaced by 01761234567890@gateway.sms77.io
.
Subject
In the subject line, enter the parameters needed to control the SMS transmission. These should each be separated by a space. To set a parameter, write the name of the parameter followed by an equals sign and the value of the parameter, each with no spaces in between.
For example with aParameter=aValue
the parameter aParameter
is set to aValue
. If the parameter contains spaces, it is necessary surround it into double quotes "
– e.g. aParameter="A value with spaces"
.
Content
The SMS text must be sent in the body of the email. The gateway uses the text/plain part of the email first. If the email contains only a text/html part without text alternative, an attempt is made to parse it and to get the text part from the HTML body.
You can optionally enclose the SMS text with ##
to prevent empty lines or the signature of the email from being in the SMS text. Then the text would look like this: ##This is the SMS text##
Required parameters
Parameter | Description | Examples |
---|---|---|
key |
The access key, which you have specified in your Email2SMS Settings for the respective sender email. This parameter is mandatory. | YourEmail2SMSKey |
Alternatively, the parameter key
can also be specified with the email recipient but thereby have to be separated by a dot .
from the recipient number. The recipient of the email would thus be RecipientNumber.Email2SMSKey@gateway.sms77.io
.
Optional parameters
Parameter | Description | Examples |
---|---|---|
from |
The sender of the SMS. Unless specified here, the default sender will be used from your SMS settings. Up to 11 alphanumeric or up to 16 numeric characters are possible. | companyABC 01760897654321 |
to |
The recipient of the SMS. If specified, this parameter overwrites the recipient specified in the recipient address of the email. Thus you could e.g. send an email to gw@gateway.sms77.io with the parameter to=recipient . The SMS is then sent to recipient . |
01761234567890 00491761234567890 491761234567890 NameOfContactOrGroup |
text |
If you are not able to place the SMS text into to mail body you could send it us as text parameter in the subject. |
“This is the SMS text.” |
flash |
Send a Flash SMS which is shown directly on the recipient’s display and is not stored. | yes no (default) |
unicode |
Forces encoding as Unicode or GSM 03.38. | yes – enforces Unicode encodingno – enforces GSM 03.38 encodingauto – automatically detect encoding (default) |
performance_tracking |
Activates our URL Shortener and performance tracking for links found in the text. | yes no (default) |
foreign_id |
Provide your own ID for this message. You will get the foreign_id in return back in DLR callbacks etc. Max. 64 chars, allowed characters: a-z, A-Z, 0-9, .-_@ |
id12345 |
delay |
Schedules the delayed sending of the SMS in the future. Enter here either a Unix timestamp or the time in the format YYYY-MM-DD hh:mm:ss. | 2025-12-01 17:17:17 1701451037
|
First example
In the first example, a SMS is sent to the phone number 0163123457890
by the sender MyDentist
. The Email2SMS key in this case is email2sms_key
.
The text to be transmitted in the SMS is Dear Mr. Schubert, we would like to remind you of your appointment on January 20th at our doctor's office. We look forward to seeing you. Sincerely, your dentist
.
Second example
In the second example, a SMS is sent to the contact Bartscher
by the sender optician
. The specification for the number 0163123457890
from the email recipient is overwritten by the parameter to
. The Email2SMS key is 123456789
.
The text to be transmitted in the SMS is Dear Mrs. Bartscher, your glasses are ready for collection. Please pick them up soon. We look forward to seeing you. Sincerely, your optician
– the signature of the email below is not sent in the SMS, because the text is enclosed by ##
.
Third example
In the third example, an SMS is sent to the phone number 0163123457890
. The settings for the sender are used from the default settings of your Account > Settings > SMS. The Email2SMS key is integrated here directly with the recipient of the email and set as abcd123456
.
The text to be transmitted in the SMS is Dear Mrs. Bartscher, your glasses are ready for collection. Please pick them up soon. We look forward to seeing you. Sincerely, your optician
– the signature of the email below is not sent in the SMS, because the text is enclosed by ##
.