30640: Message couldn't be delivered

This error occurs when Compliance Toolkit identifies the destination phone number as having elevated compliance risk and blocks delivery. When the TCPA Known Litigators Check blocks a message, Twilio returns 30640 in the error logs and API response.

• Compliance Toolkit identified the destination number as associated with elevated compliance risk.
• The TCPA Known Litigators Check was enabled for your account or subaccount, and the destination number matched a phone number believed to be associated with prior TCPA-related legal activity.
• The message was treated as non-essential traffic, such as marketing or events, which is blocked when the destination number is identified by the known litigators check.

• Remove the destination phone number from your marketing, communication, or outreach lists.
• Verify that you have valid consent before sending messages to this recipient.
• If the message is an essential use case, set messageIntent to the correct value, such as otp, notifications, or customercare, so Compliance Toolkit can classify the traffic correctly. Essential traffic is exempt from the known litigators check.
• If you have verified consent and need to bypass this check for a specific request, set riskCheck to disable when you create the message.
• Keep compliance checks enabled by default. Use overrides only when you are confident that the recipient has provided valid consent and that your messaging complies with applicable requirements.

• Compliance Toolkit for Programmable Messaging
• Message resource API reference
• Send SMS and MMS messages