Unsubscribe Option for SMS Messages
Adding and managing opt-out/unsubscribe requests
A clear SMS opt-out method lets recipients stop messages when they no longer want them. With TNZ, they can reply with a keyword such as STOP. You can also add a clickable opt-out link to the message. TNZ records the request and blocks later SMS messages under the applicable opt-out settings.
When to add an unsubscribe option
If your messages are classified as "commercial" under the applicable Spam Act rules, adding an unsubscribe instruction is mandatory.
In other cases, adding an unsubscribe instruction is good practice to give recipients an easy way to block further messaging, reducing their annoyance, and wasting your SMS costs!
How to add an unsubscribe option to your SMS
Use an SMS reply option as the standard unsubscribe method. You can also include a TNZ opt-out link.
- Add wording such as "Reply STOP to opt out." to your message. When the recipient replies with STOP, TNZ adds their mobile number to the opt-out list. An SMS Footer is a good way to automate adding this to your messages.
- Use a clickable link: Add the
[[STOP]] command to your message. For example, "Click [[STOP]] to opt out." TNZ replaces the command with an individual opt-out link when the message is sent.
How automatic SMS opt-outs work
When an inbound SMS begins with one of the following keywords, TNZ automatically adds the sender’s mobile number to your opt-out list. Keywords are not case-sensitive.
Supported opt-out keywords
STOP
OPTOUT
OPT OUT
OPT-OUT
UNSUB
UNSUBSCRIBE
What happens after an opt-out?
If you try to send an SMS to an opted-out mobile number, TNZ blocks delivery and returns the result "Destination is blacklisted." You are not charged for the blocked SMS.
Manage opt-outs in the TNZ Dashboard
Open the Dashboard > Service Settings > Opt-Out List to review opted-out mobile numbers or add a number manually.
To check whether an inbound message triggered an opt-out or opt-in, go to View Messages > SMS Received. The message’s status shows whether the mobile number was opted out or opted back in.
Manage opt-outs across your account
By default, opt-outs apply across the account.
You can configure opt-out management by SubAccount, Department or User when separate suppression lists are needed. For example, an agency may keep each client’s SubAccount separate, while a business may separate its Accounts and Marketing departments.
In the Dashboard, open Users, select the relevant user, and review the Opt-Out Management section.
Use a user’s Opt-Out Management settings to control how opt-outs are applied.
Allow a mobile number to opt in again
A recipient can remove their number from the suppression list by replying with one of these opt-in keywords. Keywords are not case-sensitive.
Supported opt-in keywords
START
SUBSCRIBE
UNSTOP
OPTIN
OPT IN
OPT-IN
TNZ first treats the inbound SMS as a reply, then applies the opt-in to the last message sent to that mobile number. This means the opt-in applies to the user who sent the last message to the mobile number.
For developers: automate opt-out management
The TNZ REST API can list, create, update and delete opt-out entries. It also supports more specific suppression rules by message type, SubAccount and Department. See the Opt-Out API documentation for endpoints and request details.
Troubleshooting a Mobile Block
If a recipient has blocked your sending number on their phone rather than opting out through TNZ, see Messages Not Appearing on a Recipient’s Mobile Device.
Topics:
SMS