Numbers

Add Dedicated Virtual Number

Lease Number

Dedicated virtual numbers are used to receive MO (Mobile Originated) messages. They also make sure that all of your messages are sent from a number that is always the same. Dedicated Virtual Number availability is limited to certain countries. Check Global Sender ID Information for availability for your destination coutry.

post/lease-number.json

Request

  • Base URL
    https://api.transmitsms.com
  • Auth
    HTTP basic

Request body application/x-www-form-urlencoded

numberinteger

Number to lease. Omit this field to be given a random number. Use "get-numbers" to find out which numbers are currently available.

forward_urlstring uri

Assign a callback URL to the number. A URL on your system which we can call to notify you of incoming messages. If required, this parameter can be different for each message sent. Will override the default Reply Callback URL if set in the SETTINGS section of your account.

Response

Successful response

numberstring

Number assigned to your account

pricenumber

Monthly cost of number leased in account currency

next_chargestring date

Date of next monthly charge. In ISO8601 format (YYYY-MM-DD).

auto_renewboolean

Returns auto_renew status of number. Always returns true for new number.

Changes

No recorded changes to this operation across all 2 revisions of this API.