Twilio support for opt-out keywords (SMS STOP filtering)

Twilio, by default, handles standard English-language reply messages such as STOP, UNSTOP, UNSUBSCRIBE or CANCEL for Toll-Free and Long Code messages, in accordance with industry standards. Supported opt-out and opt-in keywords for Twilio Programmable Messaging are listed below.


Any of these STOP keyword replies will prevent a customer from receiving new messages from the Twilio phone number they're responding to. When Twilio receives one of these replies, we will create a "blacklist" entry on our side, and then pass the message on to your webhook. Once we have a blacklist entry for a particular recipient phone number, any future attempts to message them will be met with a 400 response from our API, along with Error Code 21610 - Message cannot be sent to the 'To' number because the customer has replied with STOP. Recipients can disable this message stop, and resume receiving messages with the START, YES, or UNSTOP commands as outlined below.

Only single-word messages will trigger the block. So, for example, replying STOP will stop the customer from receiving messages from that particular Twilio number, but replying "STOP PLEASE" or "PLEASE CANCEL" will not. Further, the block works and is logged even if your number currently has no messaging request URL.

Please note that these STOP keyword replies only apply to the most recent number that messaged the recipient. If you are using more than one Toll-Free number or Long Code for sending messages, you must take additional action separate from Twilio to prevent these customers from receiving messages from your other numbers. We recommend "blacklisting" numbers on your side when one of these message responses is received at your webhook.


Any of these replies will opt customers back in to the messages coming from a Twilio Long Code. These messages will also be delivered to your Twilio account, and the defined web hook, so you can update your application logic.

Please note that Toll Free numbers only respond to UNSTOP.


Either of these replies will return a message informing the customer that they can use the above commands to control the delivery of messages. Twilio does not forward these messages to your web hook. 

It is currently not possible to customize the default response triggered by these keywords. 

Messaging Services

When using a Messaging Service to send SMS messages, any STOP keyword replies will apply to the entire range of phone numbers enrolled in this service. Similarly, a START keyword will disable our blacklisting, and allow messages to this recipient once more.

Short Codes 

Twilio does not handle default STOP keyword filtering for short codes. For information on short code HELP and STOP responses, please see this article


Text message campaigns may be subject to various legal compliance requirements depending on the nature of your text messaging campaign, the location from where you are sending your text messages, and the location of your recipients.  While Twilio will handle the above-described messages on Long Codes and Toll-Free numbers in the way described in this article, you should consult with your legal counsel to ensure that your text messaging campaign conforms will need to meet all applicable legal compliance requirements. 

If you have further questions on this, please contact Twilio Support.



Have more questions? Submit a request
Powered by Zendesk