1. Home
  2. Gateway
  3. Email to SMS
  4. Send SMS

Send SMS

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 encoding
no – enforces GSM 03.38 encoding
auto – automatically detect encoding (default)
performance_tracking Activates our URL Shortener and performance tracking for links found in the text. yes
no (default)

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.Example email2SMS reminder

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 ##.
Example Email2SMS - Pickup

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 ##.
Example Email2SMS

Was this article helpful to you? Yes 1 No
Menu