Sorry, you need to enable JavaScript to visit this website.

You are here

Get Started with the TelstraDev Messaging API

BY Michelle Howie 03 August 2020

Have you ever wondered what an API is and why you should care?

Have you ever had a mid-career crisis and considered going back to uni for a computer science degree because coding is the future?

Have you heard me talk about the Messaging API and want to try it yourself?

Then you've come to the right place!


Automation and web integration are absolutely key parts of any cutting-edge technology solution. But you don't need to be a software developer to implement your own API driven outcome! In the below video, we'll hear about some non-techie use cases for Communications as a Service APIs (i.e sending a text with a line of code) that can transform any workplace by reducing manual work. Be you a restaurant shift worker, a senior marketing specialist or a plumber, I want to empower you across every industry and level of software expertise!


An API, or an Application Programming Interface, is just that: an interface to an application surprise 

They allow different software services to communicate with each other to; access data, hide complexity, extend functionality and implement security layers of the services and apps we use every day. When you re-share articles to facebook, or get a delivery alert from the post office, you're interacting with APIs!


Think of APIs as the 'middle person' that deals with all the many databases and integrated services behind it. Just like how a waiter takes your requests for meals and responds with some yummy food, without YOU as the client having to care about the recipe or stock levels of the fridge. All you need is a menu (we've got API menus, aka API documentation, right here on the TelstraDev portal too). I just LOVE this analogy, read more here


The Messaging API in particular, allows scalable automation of services that make workflows faster and more productive. Texts are much more likely to be opened that emails, which is key for critical communications like Alerts, Confirmations, Warnings and One Time Passwords. Think about a medical receptionist having to text all of the patients booked that day to confirm their appointments... no way! They would just run a script which sends automated reminders out and updates the doctor's availability if they reply 'cancel appointment'.  Are you seeing how simple these API things can be?


If you're not quite with us yet, don't fear! I've recorded a short video to introduce the benefits of Web APIs in simple, non-technical, no-jargon human speak, and given an easy step by step guided tutorial through the Messaging API for someone who has never written a line of code before! cool

By the end of the 13 minutes, you will be able to send an SMS to yourself using an API call! (did I mention, NO CODING EXPERIENCE necessary!)

[updated 31/8/20] - Please note that the below tutorial was created BEFORE the implementation of the new BNUM endpoint, which you now need to register before sending an SMS. Consider your new virtual mobile number as the A number, the B NUmber (BNUM) = the mobile number who will receive the text.

If you are using the Postman Collection from the Messaging API documentation, you will need to open the NEW collection which includes the BNUM endpoint in a "Free Trial" subfolder: 

After you have created an OAuth token and provisioned your mobile subscription, then you can set the list of registered numbers to whom you can send messages with the API.

Open the body of this API call, and replace the default "BNUM1" text with "+61487654321" (replace with your number). I recommend you only start by provisioning 1 B number first, to check that it works, and send a few SMS messages to that number. 

More detilas in the API Documentation here: BNUM endpoint , if you get stuck, post on our  community forum



If you enjoyed this tutorial, and want to take the next step in your API journey, let me know in the comments! What should we cover next?


Keep in touch with TelstraDev on Twitter @TelstraDev and with me, your Developer Advocate @Michelle2Minhye to see our latest updates!


Michelle, TelstraDev Developer Advocate


Related Blogs

iot home garden project with arduino and azure
anonymous's picture

By keith coutlemanis


  • arduino
  • azure

Azure IoT garden project with Arduino

In this blog, I'll showcase some of the interesting things you can do with the Internet of Thing...
anonymous's picture

By Trent Steenholdt


  • iot
  • azure

A home IoT project using Azure

In this blog series, I'll explan how I used the Internet of Things (IoT) to enable my gate, gara...
anonymous's picture

By Christy Daguia


  • messagingAPI
  • replyRequest

Conversation via Telstra Messaging API

Creating a message thread can be done via Telstra Messaging API, whereby you can continue sending an...
anonymous's picture

By Rajeev Ramani


  • MMS
  • performance

Fine-tuning MMS performance on Telstra's Messaging API

  Here at TelstraDev, we strive to make the best possible developer experience, from the recen...
anonymous's picture

By Marcus Kennan


  • callbacks
  • Messaging SDK

Understanding Messaging API Callbacks - Part 2

Welcome to the second in a two part series on understanding the messaging API callbacks. In our firs...
anonymous's picture

By Marcus Kennan


  • callbacks
  • postman

Understanding Messaging API Callbacks - Part 1

The callback functionality of the messaging API is a great utility allowing you to track the deliver...