Portal FAQs

How do I create an app or create client_id and client_secret to interact with an API?

1. Login and Switch to your account profile (in the drop-down menu next to Telstra Developer logo).
2. From Dashboard Under API Keys tile select View API keys.
3. Select Create API Key 
4.  Provide a name in the field "API key name"
5. Optionally, provide an expiry date. Caution: The access will be permanently removed after this expiry date. Expiry date cannot be changed once created.
6. Select API(s). Note: Some APIs may require configuration so may not be available to use immediately. 
7. Hit create.
8. Start using the keys generated to interact with APIs available to use.  Note: The APIs pending configuration, will be reviewed and approved by our operations teams and you will be notified once it is ready to use.

The difference between live and test environments (applicable to Telstra Wholesale accounts only)

A test environment uses dummy data whereas a live environment references real data and production systems.
If you feel you need to change environments, please contact your customer administrator.

Application status (applicable to Telstra Wholesale accounts only)

Your status will either be Pending, Approved or Revoked. Test environment apps are automatically approved, but new apps in the live environment will need to be approved first.

Revoked API product

If your product has been revoked, you won’t be able to use your key or secret credentials. Please contact Support if you need the product reinstated.
I'm an independent developer and just want to try out the APIs. What can I do?
Once you register on the portal for the first time, you’ll be able to create keys using above steps for the APIs displayed in the page.

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. The limit per user as of August 2020 is 100 messages. If you’d like to continue using the API, you will need to purchase a plan by creating an account 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, create a new app with the same APIs.

Note: Do NOT delete the Free Trial app if you are using Messaging API, as you will not be able to create another mobile subscription due to limits of one subscription per free trial developer.

How do I use the APIs?
One of the quickest ways to get started is to use the API catalogue to understand the interaction steps.

We have published several tutorials on our blog for you to try: https://dev.telstra.com/blog/tutorials

Are there any SDKs, or sample code, I can use to quickly create my app?
Yes, our APIs have SDKs for popular languages, and we have sample code for our APIs as well in the API Documentation. 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?
Check out the API documentation which includes common error messages. If you can’t find an explanation, please reach out to us on telstradev@team.telstra.com Telstra team member will respond shortly.

How can I add billing details to my developer account?
Billing details are associated to a ‘company’ in TelstraDev. To create a company, log into the TelstraDev portal and go to Create and Manage Companies under your profile name in the top menu bar. At this step, you will be asked for your billing details. All purchases made on the portal under this new ‘company’ will be charged to your preferred billing method.

When are invoices generated?
If you are paying by Telstra Bill, you will receive your bill as per nominated billing cycle.

Is there a dollar limit on my purchased plan?
If you are paying by Telstra Bill, you do not have a limit.

I’ve created a company and added my billing details.  How long till I can use my API plan?
If you create a company with your existing Telstra billing account details, we’ll need 2-5 days to validate your Telstra billing account. You’ll receive an email when billing validation is complete. We will also create a default App (Production API keys) which includes access to the Messaging API. If you have purchased a valid IoT Device (e.g Arduino Dev Kit or Track and Monitor Device) you will already have access to other Production APIs like the Connected Things API.

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. Please check those details and submit again, or contact telstradev@team.telstra.com

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.

How do I setup account with billing (Not applicable for Telstra Wholesale customers)?

1. Login and Switch to your account profile (in the drop-down menu next to Telstra Developer logo).
2. From Dashboard Under Billing select Add billing details
3. Select Add a billing account
4. Provide details based on your circumstances
5. Once your details have been validated you can start to use the PAYG plan
6. 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 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.  ALternatively, you can setup billing details from the instructions above.

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.

How do I add users to my account/company?
To invite a developer to your account/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. Note: If you are Telstra Wholesale user, please contact support for inviting others to the account. 

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 accounts/companies?
Yes, you can.

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. Check the API or IoT Device specific documentation for the offshore feature availabilities.