Skip to content

POST /sms

Send a short text message (SMS) to a specified phone number.


Request

POST /api/{account}/v4.0.0/sms?nonce={nonce}
Authorization: Bearer <xa-token>
Content-Type: application/json

Parameters

Name In Type Required Description
nonce query integer (int64) Yes Client-generated unique sequential number

Request Body

Pass a JSON object with the SMS details. The body schema is not formally specified — contact support@gestix.com for the expected fields.


Responses

201 — Message sent

The SMS was successfully submitted.

400 — Invalid input

Returned when required parameters or body fields are missing or invalid.


Example

curl -X POST \
  "https://gestix.pt:443/api/03101176/v4.0.0/sms?nonce=1700000000001" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+351912345678", "message": "Your order is ready." }'