provision a new sender id

API Docs by APIMATIC

Provision a New Sender ID

Use this method to allow list a new Sender ID on the account

This endpoint requires authentication.

POST /messages/sender_ids
  • EXPLORER
  • PARAMETERS
Endpoint Arguments*
Parameters*
body (SenderIDRegistrationRequest)*

SMS Sender ID to be registered on the platform

Name of the Sender ID. Can be either an alphanumeric string or a DID number.

countries*

An array of 2 letter ISO codes of the countries the Sender ID to be allow listed in

Server

Messaging

Response Type

Errors

HTTP Status CodeError DescriptionException Class
400
Sender ID cannot be provisioned. The response indicates the reason for the error.
403
Request failed. Outbound SMS messaging service is disabled.
curl -X POST \
  --url 'https://api.wavix.com/v2/messages/sender_ids?appid=appid' \
  -H 'Accept: application/json'\
  -H 'Content-Type: application/json' \
  --data-raw '{
  "sender_id": "Wavix",
  "type": "alphanumeric",
  "countries": [
    "GB",
    "FR"
  ]
}'