These FAQs cover general questions about the TelstraDev portal.
For questions related to a specific API, please see that API’s documentation.

APIs, apps and keys

Where can I find my free trial keys?

Upon registration, we have created your first app with access to the free trial APIs which you can find via My Apps & Keys.

I am getting an error “Quota reached” on my free trial keys, what does this mean?

You’ve exceeded your free trial limit for that API. If you’d like to continue using the API, you will need to purchase a plan by creating a company profile and entering your billing details.

How do I get new keys for my existing apps?

We recommend that if you would like new keys immediately, delete your current app and create a new app with the same APIs.

Alternatively, contact Telstra (telstradev@team.telstra.com) to renew keys for an existing app.

How do I use the APIs?

Telstra provides SDKs for most common languages and Postman collections for each API.

One of the quickest ways to get started is to use the Telstra provided Postman collections.  To find Postman collections for an API, find the Postman button in the Getting Started section of each API.  After you download the collection, you will need to add your API keys.

Are there any SDKs, or sample code, I can use to quickly create my app?

Yes, all our APIs have SDKs for popular languages, and we have sample code for our APIs as well. Check out our open source Github repo at https://github.com/telstra/.

I am getting an error that I don’t understand, where should I go for help?

Post any questions on our developer forums and a Telstra team member will respond shortly.

I’ve purchased a plan. How do I start using it?

Once you have purchased a plan you will need to create a new company app to get API keys for your purchased plan.

  1. Login with your developer account.
  2. Switch to your company profile (in the drop-down menu under your name in the top menu bar).

Figure 1 Where to switch to your company profile

  1. Go to My Apps & Keys
  2. Create a new app with your purchased package, specify a name and create your app. You can now use the key and client ID under the new app you created.

Company and billing details

What payment methods do you accept on TelstraDev?

You can choose to pay by credit card or Telstra Bill.

What types of credit cards are accepted by TelstraDev?

At this point in time, TelstraDev accepts Visa and MasterCard credit cards.

Why am I getting an error message when entering my credit card details?

The details you are entering may be incorrect or TelstraDev does not accept your card type.  Please check your details and try again.

Are my credit card details stored on the portal?

No credit card details are stored on the TelstraDev portal.

When are invoices generated?

If you are paying by Credit Card, the company admin will receive an invoice on the 3rd business day of each month after charges have been posted.

If you are paying by Telstra Bill, you will receive your bill as per normal.

Is there a dollar limit on my purchased plan?

If you are paying by credit card, you will be limited to $1000 in API usage per month.  You will receive notifications at $500, $800 and $1000 to inform you of your usage.

If you are paying by Telstra Bill, you do not have a limit.

Are all the API features available if I pay by credit card?

Most features are available; however, you will be restricted from accessing some API features if your current billing method is credit card.  Check the pricing & plans page to find out more.

I want to purchase a plan on a Telstra billing account but I don’t have one - can one be created for me?

Yes.  Contact your account executive or email us at telstradev@team.telstra.com and we’ll work with you to get a new billing account created.

I’ve created a company and added my billing details.  How long till I can use my API plan?

If you are paying by credit card, you will get access to your API plan immediately. 

If you are paying by Telstra Bill, we’ll need 2-5 days to validate your Telstra billing account and confirm it’s in the right format for billing.  You’ll receive an email when billing validation is complete.

I added my Telstra billing account details but received an email saying my billing details could not be validated. Why is this?

There are a few reasons why your account details may not have been validated. The Telstra account you provided may have been in an incorrect format or the billing details you entered do not match our records.

I received an email that my billing details have been validated. What do I do now?

Log into TelstraDev and select your company profile. From here, you can create a new app via “My apps & keys”.  Add an app with your purchased package, specify a name and create the app. You can now use the new app key and client ID to access all the plan features.

I changed my billing details in the middle of the month, what billing details will be charged?

We will post all your charges for the previous billing period to whatever your current billing method is on the 3rd business day of the month.

Plans and usage

How do I buy the PAYG plan?

You will need to create a company and enter your credit card details, or link your Telstra billing account;

  1. Go to Pricing & plans and select Buy now for the PAYG plan
  2. Enter your Company and billing details and Submit.
  3. Once your details have been validated you can start to use the PAYG plan
    1. If you are paying by credit card, you will get access to your API plan immediately. 
    2. If you are paying by Telstra Bill, we’ll need 2-5 days to validate your Telstra billing account and confirm it’s in the right format for billing.  You’ll receive an email when billing validation is complete.

  4. Log into TelstraDev and select your company profile. From here you can create a new app via “My apps & keys”.  Add an app with your purchased package, specify a name and create the app. You can now use the new key and client ID to access all the plan features.

I want to upgrade my plan to an enterprise contract, who do I contact?

Complete the sales enquiry form and one of our sales representatives will be in touch.

Where do I go to see my plan usage?

If you’re using the free trial, you can see your usage via the analytics tab of your app.

If you have a paid plan you can find out how much of your plan you’ve used via the billing reports.

Is there any set-up fee on the PAYG plan?

No, all fees charged are based on usage as defined in the PAYG plan.

I want to cancel my plan.  Who do I contact?

Email us at telstradev@team.telstra.com with your contact name, company name, plan and preferred plan end date.

User management

How do I add users to my company?

To invite a developer to your company they must have already registered on the portal. Go to the “Manage Users” page and enter a user’s email and invite the developer.  The developer will need to login and accept the invitation to the company before they can view the company’s profile.

What roles can I give user’s in my company?

By default, invited users will have the role “Developer” which allows them to view the company’s apps and keys.  You can increase the user’s privileges by giving them the “Monetisation Administrator” role which allows them to do everything in the company.

I want to change my company administrator/owner.  Who should I contact?

Email us at telstradev@team.telstra.com with the new company administrator’s email and your company details. The new "owner" of the company may be asked to confirm they agree to be contacted in case of billing issues.

Can I be part of multiple companies?

Yes, you can.

General

Why can’t I see my paid plans when I log in?

When you log in you’ll be taken to your personal profile each time.  Use the navigation bar to switch the profile to the company under which you purchased a plan.

Do the features included in my paid plan work in all countries?

Our API and SDK services are globally available.

I'm an independent developer and just want to try out the APIs. What can I do?

Once you register, you’ll be provided a profile with which you can trial APIs.  Our free trial allows access to the Messaging API (1000 free SMS/MMS) and WiFi Locator API.

What is the Service Availability on the APIs?

Our Service Availability on all APIs is 99.95% unless stated otherwise.

MKR NB 1500 FAQ

Important – take extra care when clipping the MKR NB 1500 antenna on and off as the clip is very small and quite easily broken! Accidental damage is not covered under the Voluntary Product Warranty that comes with the MKR NB 1500.

Where do I get the Arduino NB library for the MKR NB 1500?

The official library is available at https://github.com/arduino-libraries/MKRNB. The library is also available via the latest Arduino IDE by going to Sketch > Include Library > Manage Libraries and searching for MKRNB.

I’m having issues with the Arduino library

Checkout the Arduino support forums at https://forum.arduino.cc/index.php?board=107.0. Also have a look at the MKR GitHub repo https://github.com/arduino-libraries/MKRNB.

What is the difference between Narrowband and Cat-M1?

Both Narrowband and Cat-M1 are IoT-centric networks, but there are some key differences between them.

The main differences are network reach, with Telstra’s Narrowband network having over 3.5 million sq kms of coverage in Australia and Telstra’s Cat-M1 having over 3 million sq kms of coverage in Australia.

Finally, typically you can expect lower power usage with Narrowband, but this depends on the use case and setup.

For additional information refer to

https://www.telstra.com.au/content/dam/tcom/business-enterprise/machine-to-machine/pdf/business-support-m2m-telstra-wireless-application-development-guidelines.pdf

Can I use a data SIM card in a Cat-M1/Narrowband device?

No, you cannot use a LTE (4G) data and voice SIM card in a Cat-M1 and Narrowband specific device, as it connects into a different network type. You have to acquire a Cat-M1 or Narrowband SIM for use with these networks.

Where can I check IoT coverage?

IOT coverage can be found here https://www.telstra.com.au/business-enterprise/solutions/internet-of-things/iot-coverage.

I need more M2M SIMs, where can I get them?

If you need more M2M Cat-M1 or Narrowband SIMs drop us a line via one of our contact methods at https://dev.telstra.com/support

The IoT device is connected to Telstra’s network but doesn’t get data from anywhere

Check the libraries you are using especially making sure you have the latest version of the MKR NB 1500 library https://github.com/arduino-libraries/MKRNB. Check the SIM card is installed correctly and has been activated via the dev portal also checking that you have Cat-M1 coverage available via the coverage maps https://www.telstra.com.au/business-enterprise/solutions/internet-of-things/iot-coverage.

My MKR NB 1500 device won’t do anything

Try running the blink sketch that comes with the Arduino IDE which will make LED 13 blink on the board. Also try doing Serial.println output to show what the device is doing.

I need a bulk order of the devices, where do I get them?

Reach out to us via our contact methods at https://dev.telstra.com/support

My M2M SIM is broken/lost how do I get a new one

Drop us a line via one of our contact methods here https://dev.telstra.com/support

My antenna clip has broken, what can I do?

Good question and you need to take extra special care when dealing with this tiny component, sadly there is no way that this can be reattached beyond trying to solder the clip back on.

I ordered an MKR NB 1500 and I didn’t get a … [SIMcard/antenna/board]

We will look into your order for you, please drop us a line via one of our contact methods here https://dev.telstra.com/support and include your order number.

I built a really amazing thing that I want to share

We want to hear from you, reach out via https://dev.telstra.com/support so we can chat about getting a writeup or blog post.

How do I get more involved with open source projects?

Open source projects are always looking for people to get more involved. While most are code based you don’t have to write or contribute code to a project, just testing a new version of the library or proof reading READMEs. Head on over to https://github.com/Telstra or https://github.com/Arduino-libraries to get started