Sending messages through the MessagePort REST API is quick and easy.

1. 1. 1. Login to your account and click on Settings > API.
      2. Click Create API Key to generate a new key to use for your application.
      3. Now that your API Keys have been generated you can connect to the API.

End Point https://messageport.com.au/rest/v1/messages

Method POST

POST Parameters 

number

message

senderid *optional*

reference *optional*

Authentication Basic

curl -X POST https://messageport.com.au/rest/v1/messages\

-d "number=61440111222" \

-d "message=Hello World" \

-d "senderid=Edgility" \

-d "reference=APIMessage1" \

-u 'Access_Token:Token_ID'

200 Success

Upon successfully sending a message you’ll get a JSON string returned

{"code":200,"errors":0,"message":""}

If the ‘code’ in the JSON string or the HTTP Header are equal to 200 then your message has been successfully sent.

If you receive any other code or HTTP Header then you’ll receive an error message.

View REST Response Headers for a list of API responses

When using the REST API to send messages it’s possible to receive any of the below response headers.

{"code":200,"errors":0,"message":""}

{"code":400,"message":"Validation Failed","errors":{"children":{“message":{"errors":["Message field not supplied"]},"number":[],"senderid":[],"reference":[]}}}

{"code":400,"message":"Validation Failed","errors":{"errors":["This form should not contain extra fields."],"children":{"message":[],"number":[],"senderid":[],"reference":[]}}}

{"code":400,"message":"Validation Failed","errors":{"children":{"message":[],"number":{"errors":["Number field contains invalid characters"]},"senderid":[],"reference":[]}}}

{"code":402,"errors":402,"message":"Not enough credits"}

{"errors":{"auth":"Authentication failed."},"code":403}

{"code":405,"errors":405,"message":"GET Method Not Allowed"}

{"code":406,"errors":406,"message":"Number is opted out"}

{"code":409,"errors":409,"message":"Country not supported"}

There are two option when setting up SMTP Email to SMS template.

Option 1

Open reply path allowing recipients to reply to your SMS. When using this options the system will randomly select one of the shared mobile numbers for your send.

You can add as many numbers X-CELLPHONE: 04xxxxxxxx

So if you want to send to two numbers, 0447100200 and 0447100250 with the message Sample Message

The email would look like;

To sms@smsmail.com.au
Subject Leave Blank

Body
X-CELLPHONE: 0447100200
X-CELLPHONE: 0447100250

Sample Message

The message above is using an open reply path allowing recipient to reply. Replies come back into your web inbox and a copy sent to your email.

Option 2

Defining your Sender ID, you have the option to set an Alphanumeric Sender ID (eg touchSMS) or use a Virtual Number. Using an Alphanumeric Sender ID your recipients will not be able to reply to your SMS.

If you want to use a Sender ID then you need to add X-FROM-CELLPHONE
If you want the message coming from Edgility your email would look like this;

To sms@smsmail.com.au
Subject Leave Blank

Body
X-CELLPHONE: 0447100200
X-CELLPHONE: 0447100250
X-FROM-CELLPHONE: Edgility

Sample Message

Integrating via Zapier

Zapier allows you to connect your touchSMS Account to over 1500 other applications. With the power of Zapier you can automate your workflows so you can focus on more important tasks.

What is Zapier?

Zapier is an online automation tool that connects your favorite apps, such as Gmail, Slack, Mailchimp, and over 1,500 more. You can connect two or more apps to automate repetitive tasks without coding or relying on developers to build the integration. It’s easy enough that anyone can build their own app workflows with just a few clicks.

What do I need to get started?

Zapier will be launching Soon.