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 (Sender ID Registration Request)*

SMS Sender ID to be registered on the platform

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

Sender ID type. Can be either numeric or alphanumeric

countries*

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

Server

SMS and MMS 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=your-API-key' \
  -H 'Accept: application/json' \
  -H 'Content-type: application/json' \
  --data-raw '{
  "sender_id": "Wavix",
  "type": "alphanumeric",
  "countries": [
    "GB",
    "FR"
  ]
}'