SERVICES | SMS | APIS

Integrate New Zealand SMS with one HTTP POST

Send SMS to New Zealand, Australia and more than 100 international destinations.
Receive delivery results and SMS replies through webhooks.

Use the REST API directly or choose a supported library for .NET, Python or Node.js/TypeScript.

START YOUR FREE TRIAL →
Developer working at a laptop with code displayed on screen

Send SMS. Receive results and replies.

Post JSON to the TNZ REST API, or use a supported library for .NET, Python or Node.js/TypeScript.

Configure a webhook URL and TNZ will post delivery results and inbound replies to your application as they arrive.

Each delivery result includes the message price, making it easier to allocate costs or rebill clients from the same event data.

POST api.tnz.co.nz/api/v3.00/sms
--header 'Content-Type: application/json'
--header 'Authorization: Bearer YOUR_TOKEN'
--data '{
 "Message": "SMS notification from Company One Ltd. Reply STOP to OptOut.",
 "Destination": "021-000001"
}'

Supported Libraries

REST

REST API

JSON or XML REST API

  • Multi-channel support: SMS, Email, Voice, Fax.
  • Webhook reports: Capture delivery and reply details.
  • Files and links: Send trackable files and short-links.
  • Address book: Update contacts and manage opt-outs.
  • Cross-platform: Compatible with any HTTP-based platform.
DOCUMENTATION
.NET

.NET Library

nuget or DLL

  • Native integration: Seamless with .NET apps.
  • Multi-channel messaging: SMS, Email, Voice, Fax.
  • Snippets included: Ready-to-use .NET examples.
  • Error handling: Robust, reliable delivery.
  • Comprehensive docs: Detailed .NET developer guides.
DOCUMENTATION
Python

Python Library

pip or library

  • Python interface: Familiar, intuitive API calls.
  • Multi-channel support: SMS, Email, Voice, Fax.
  • Developer-friendly: Includes useful snippets.
  • Cross-platform: Works with various Python environments.
  • Easy install: Available via pip.
DOCUMENTATION
TypeScript

TypeScript

npm or library

  • Native integration: TypeScript/Node.js-compatible.
  • Async operations: Optimised for scalability.
  • Real-time capabilities: Ideal for event-driven applications.
  • Snippets included: Developer tools for quick setup.
  • Framework support: Compatible with modern frameworks.
DOCUMENTATION
VBA

VBA Integration

Macro or DLL

  • Office integration: Excel, Access, etc.
  • Legacy support: Extends older systems.
  • Snippets included: VBA examples provided.
  • Unified API: Consistent across Office apps.
  • DLL support: Advanced functionality.
DOCUMENTATION
TNZ MCP Client

MCP Client

Python package (beta)

  • AI integration: Connect supported AI and LLM tools to TNZ.
  • Multi-channel messaging: Send SMS, Email, Voice and Fax.
  • Local control: Runs on your infrastructure.
  • Message tracking: Check delivery results and SMS replies.
  • Easy install: Available via pip for Python 3.10+.
DOCUMENTATION
SMTP

Email-to-SMS

SMTP API

  • Email integration: Converts email to SMS.
  • Universal access: Any SMTP-capable email client.
  • Quick setup: Minimal configuration required.
  • Seamless automation: Automate from existing workflows.
  • Cost-effective: Leverages email infrastructure.
DOCUMENTATION
More

SMPP, FTP

and more...

  • Send and receive SMS using SMPP or FTP
  • Delivery acknowledgement support
  • CDR reporting for rebilling
  • API Tools for managing accounts
DOCUMENTATION

App Integrations

Postman

Postman
REST

PowerShell

VIEW
PowerAutomate

Power Automate

VIEW
AWS

AWS LAMBDA

VIEW

SMS Sending Numbers

Built-In Short Codes

When you send SMS in New Zealand, your messages come from a TNZ Short Code, a 4-digit number like 3003. One is assigned to you automatically based on your message type. It's instant and included in your plan.

Most businesses start here. Built-in Short Codes work well for appointment reminders, alerts, and general business messaging, with no setup required.

Dedicated Short Codes

If you're running keyword campaigns (e.g. "Text INFO to 3003"), want full inbound SMS from any NZ mobile, or are building long-term brand recognition, a Dedicated Short Code gives you exclusive ownership of your number.

Not Sure Which You Need?

Start with a built-in Short Code and upgrade if you need more. Talk to our team, we'll give you an honest recommendation.

GET IN TOUCH DEDICATED SHORT CODES

Built-In Short Code

Included in your plan

  • ✔  Automatically allocated based on your message type
  • ✔  Ready in minutes
  • ✔  Limited inbound SMS support (restricted to recent replies only)
  • ✔  Mobile pays to reply

Dedicated Short Code

Available as an add-on, view pricing and details

  • ✔  Your exclusive 4-digit, 5-digit or 6-digit number
  • ✔  Full inbound SMS, receive replies from any NZ mobile, anytime
  • ✔  Run unlimited SMS keyword campaigns (e.g. "Text INFO to 3003")
  • ✔  Build consistent brand recognition across all your messages
  • ✔  Choose Standard Code or Free-to-Text (free for the mobile to reply)

One platform, one subscription, all the tools

Start with SMS, then add email, voice, text-to-speech or fax through the same TNZ REST API when your application needs them. The same authentication and account structure carry across, so you can extend your communications without integrating another provider.

Your subscription also includes the tools needed to operate messaging at scale, including webhooks, API users, SubAccounts, Departments and itemised reporting. Use them to separate applications or clients, track costs and simplify rebilling.

Local Expertise & Support

Our New Zealand-based support team is on hand to assist you, offering expert knowledge and real-time solutions, ensuring you're never alone.

CONTACT US

Developer-Friendly Automation

TNZ's API integration caters to developers looking to automate messaging within their applications, complemented by additional tools like our SMS URL Shortener, SMS Landing Pages, and more to enrich user interactions.

Our $20 Starter Plan Offers You

Experience the difference with a complimentary trial. Discover how our messaging solutions can elevate your business communications. Free Trial. No credit card, no commitment.

  • One platform, one subscription
  • No Minimum Term
  • 20 Team Members
  • Dashboard, APIs & Integrations
  • SMS, Email, Voice & Fax features
  • $0 Set Up Fee
  • $20 Monthly Fee
  • SMS from 10c / SMS Part

SMS API FAQs

Send an HTTPS POST request to the SMS endpoint with your Bearer token, message, and destination. You can call the REST API directly or use a TNZ library for .NET, Python, or Node.js/TypeScript.

Create or select a user in the TNZ Dashboard, enable API access, and generate an Auth Token. Include it in each request using the Authorization: Bearer YOUR_TOKEN header. The Auth Token is a long-lived access token, so it does not need to be constantly refreshed; replace it only when you need to rotate or revoke access.

Yes. Set the API request's Mode field to Test. TNZ will process the request immediately as successful without sending a live message, allowing you to test your application flow safely.

A built-in New Zealand short code is assigned automatically and can be ready in minutes. Once you have created an API-enabled user and generated an Auth Token, you can begin integrating. Dedicated short codes require provisioning and currently take around four weeks.

TNZ automatically assigns a built-in short code based on your message type, and it is included in your plan. You do not need to set the FromNumber API variable (it's automatically applied). Alternatively, choose a dedicated 4-, 5-, or 6-digit short code if you need an exclusive number, full inbound messaging, or SMS keyword campaigns.

TNZ can send delivery results and inbound replies to your application using webhooks. A built-in short code supports replies associated with recently sent messages; use a dedicated short code if you need inbound SMS from any New Zealand mobile at any time. You can also retrieve delivery results and received messages through the API if webhooks do not suit your application.

Yes. Use the Destinations array to submit multiple recipients, or send to a TNZ Address Book contact or group using ContactID or GroupID. The result contains delivery information for each recipient.

SMS is billed per SMS part, and the number of parts depends on the message length and character encoding. Emojis, macrons, and other Unicode characters can reduce the number of characters available in each part. The optional CharacterConversion setting can normalise some characters to reduce message size, but it removes emojis, macrons, and other special characters.

The Starter Plan is NZ$20 per month with no setup fee. SMS to New Zealand and Australian mobiles starts at 10c per SMS part. International rates start at 20c and vary by destination, while receiving costs depend on your sending-number type. Prices exclude GST. See the pricing page for current rates.

Yes. The free trial includes 20 credits valid for 14 days. No credit card or commitment is required. Create a trial account to generate an Auth Token and test your integration.

Yes. Assign SubAccount and Department values to API requests, or create separate API users for different clients and applications. Delivery webhooks include the message price, while invoices and reports itemise usage for cost allocation and rebilling.

You can send SMS to New Zealand, Australia, and more than 100 international destinations. International availability and pricing vary by destination, so check the SMS geography and pricing tiers before launching in a new country.

TNZ provides automated unsubscribe tools and an Opt-Out API. Opt-outs can be managed by message type, SubAccount, and Department. If a destination is opted out for the applicable SMS category, TNZ blocks delivery and returns a “Destination is blacklisted” result for auditing.

Yes. REST API v3.00 includes endpoints for SMS, email, voice, text-to-speech, and fax. It also provides Address Book and Opt-Out management, using the same authentication approach and TNZ subscription.

Start your free trial today!

Ready to revolutionise your messaging?
Connect with people anywhere - boost engagement, responses and conversations.

20 credits over 14-days. No obligation. No credit card required.