Skip to main content

Send SMS

PREMIUM

The Message API enables organizations to send single SMS from their authorized subscriptions directly to their customers or employees. Only predefined subscription numbers are permitted to send messages through the API.

How it works​

Send SMS​

Send messages as an HTTP POST request to 1GLOBAL, allowing single SMS messages to be sent from authorized subscription numbers to specified recipient.

POST https://api.1global.com/enterprise/sms

Include access token as described in Request Access Token in the header.

curl -X POST \
  https://api.1global.com/enterprise/sms \
   -H 'Authorization: Bearer $ACCESS_TOKEN' \
   -H 'Content-Type: application/json' \

Example Request Body:

The request body includes the MSISDN of both the authorized sender and the recepient and the text message.

{
  "from": "44123456789",
  "to": [
    "44172466777"
  ],
  "text": "Thank you for using our service."
}

For more technical details on the fields and the API, refer to the API Reference.

Example Response:

The successful response returns with a 200 status code and an id indicating that the request is accepted.

{
     "id": "sms_01JBCJCWS13VWJAHAVF3CPS12K"
}
note

A 200 response code confirms that the message request is successfully submitted to the API. However, it does not guarantee successful delivery to the recipient.