1. Home
  2. Docs
  3. Gateway
  4. Email to SMS
  5. 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

ParameterDescriptionExamples
keyThe 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

ParameterDescriptionExamples
typeThe desired SMS type. If this parameter is not set, the default SMS type from your SMS settings will be used.economy
direct
fromThe 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
toThe 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
textIf 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.”
flashSend a Flash SMS which is shown directly on the recipient’s display and is not stored.yes
no (default)
performance_trackingActivates our URL Shortener and performance tracking for links found in the text.yes
no (default)

First example

In the first example, a Direct SMS is sent to the phone number 01631234567890 by the sender MyDentist. The Email2SMS key in this case is email2sms_key.
The text to be transmitted in the SMS is Hello Mr. Schubert, we would like to remind you of your appointment on January 20th in our practice. We look foward to you! Until then, your dentist.email2sms example 1

Second example

In the second example, an Economy SMS is sent to the contact Bartscher by the sender optician. The specification for the number 01631234567890 from the email recipient is overwritten by the parameter to. The Email2SMS key is here 123456789.
The text to be transmitted in the SMS is Hello Mrs. Bartscher, your glasses are ready! Please pick them up soon. We look foward to you! Until then, your optician – the signature of the email below is not sent in the SMS, because the text is enclosed by ##.
email2sms example 2

Third example

In the third example, an SMS is sent to the phone number 01631234567890. The settings for SMS type and 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 Hello Mrs. Bartscher, your glasses are ready! Please pick them up soon. We look foward to you! Until then, your optician – the signature of the email below is not sent in the SMS, because the text is enclosed by ##.
email2sms example 3

Was this article helpful to you? Yes 1 No
Menu