SMS - Get started

API Documentation

API Swagger Documentation is available here :

URL & Base URI

Vortext API base path is located at :

All methods are relative to this URL.

For example if you want to get status of vortext, you have to use:



HTTPS Protocol

All requests to Vortext API is made by HTTP protocol, using TLSv1 transport encryption.


As for now, basic authentication is used for every request made to Vortext service. Each request is completely stateless, so you can use Vortext service with a simple line of curl. If you don’t know about basic authentication, it only needs a http request header 'Authorization' :

Authorization Basic YWRtaW5pc3RyYXRvc5cnF2NjBTenh3djRuaU5meEV5VFgwaUN4VmNTaHF1djBYU0RIbjY2

The credential used if username:password encoded in base 64. Most of libraries will simply let you provide username and password.

HTTP Request and Responses format : json

This API is aimed primarily to handle json messages in http request and response bodies.

HTTP Request format

Use Content-Type: application/json header to let Vortext service know your request body format.

HTTP Response format

Use Accept: application/json header to let Vortext service which format do you want for body response.

Date/Time format

As json doesn’t support natively Date/Time, all parameters tagged as Date in this API are string with ISO8601 format :


where Z is timezone (like +0200).

Examples : 2016-06-01T12:27:19.000+0200.

For query parameters, don’t forget to url encode these parameters.

Sender Name

You can customize sender name of SMS, instead of a classic number such as "30180". To do so, please make a request in ITCare to our team by requesting this feature to be setup.

Once your account configured, all SMS sent will be with this sender name. As per now, it is not possible to have multiple sender name per account.

PUSH responses

It is possible to receive PUSH responses (https REST call) as soon as a customer makes a response to a previously sent SMS. To activate this features, please make a request in ITCare to our team .

Here is the specifications of outbound request you will receive once activated :





HTTP method






Message Body

{ "response": { "content": "Response of your customer", "answeredAt" : "2020-02-12T13:00:00.000+0000" }, "message": { }}


You can set limits to avoid multiple calls / bad loops and prevent some flooding :

  • total SMS sent by minute

  • total SMS sent by hour

  • total SMS sent by day

To activate this features, please make a request in ITCare to our team.

Last updated