The SMS Works API
  1. messages
The SMS Works API
  • auth
    • /auth/getApiKey
      GET
    • /auth/token
      POST
  • batch messages
    • /batch/schedule
      POST
    • /batch/send
      POST
    • /batch/{batchid}
      GET
    • /batches/schedule/{batchid}
      DELETE
  • credits
    • /credits/balance
      GET
  • messages
    • /message/flash
      POST
    • /message/schedule
      POST
    • /message/send
      POST
    • /messages
      POST
    • /messages/failed
      POST
    • /messages/inbox
      POST
    • /messages/schedule/{messageid}
      DELETE
    • /messages/{messageid}
      DELETE
    • /messages/{messageid}
      GET
  • utils
    • /utils/errors/{errorcode}
      GET
    • /utils/test
      GET
  1. messages

/message/send

POST
/message/send
Send an SMS Message
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.thesmsworks.co.uk/v1/message/send' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": "Your super awesome message",
    "deliveryreporturl": "http://your.domain.com/delivery/report/path",
    "destination": "447777777777",
    "metadata": [
        {
            "key": "myKey1",
            "value": "myValue1"
        },
        {
            "key": "myKey2",
            "value": "myValue2"
        }
    ],
    "responseemail": [
        "my.email@mycompany.co.uk",
        "my.other.email@mycompany.co.uk"
    ],
    "schedule": "Sun Sep 03 2020 15:34:23 GMT+0100 (BST)",
    "sender": "YourCompany",
    "tag": "SummerSpecial",
    "ttl": 10
}'
Response Response Example
200 - Example 1
{
    "message": "string",
    "errorCode": 0,
    "permanent": true,
    "status": "string"
}

Request

Body Params application/json

Examples

Responses

🟢200Error
application/json
Body

🟢201Success
🟠402Error
Modified at 2022-09-11 19:34:57
Previous
/message/schedule
Next
/messages
Built with