POST /virtual-numbers
When a recipient receives your message, you can choose whether they'll see a Virtual Number or senderName (paid plans only) in the from field. If you want to use a Virtual Number, use this endpoint to assign one. Free Trial users can assign one Virtual Number, and those on a paid plan can assign up to 20. If you need more than 20 virtual numbers on a paid plan, please contact us at telstradev@team.telstra.com
Virtual Numbers that have not sent a message in 30 days (Free Trial) or sent/received a message in 18 months (paid plans) will be automatically unassigned from your account. You can check the lastUse date of your Virtual Number at any time using GET /virtual-numbers/{virtual-number}.
Servers
- https://products.api.telstra.com/messaging/v3
Request headers
Name | Type | Required | Description |
---|---|---|---|
Accept |
String | Yes | |
Telstra-api-version |
String | No | |
Content-Type |
String | Yes | |
Content-Language |
String | Yes | |
Authorization |
String | Yes | |
Accept-Charset |
String | Yes |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
replyCallbackUrl |
String | No |
Tell us the URL that replies to the Virtual Number should be sent to. Sample callback response:
|
tags[] |
Array | No |
Create your own tags and use them to fetch, sort and report on your Virtual Numbers through our other endpoints. You can assign up to 10 tags per number. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.