Skip to main content
Error code: DELIVERY_FAILED Should you try again? It depends on subcode. After you fix the message for the subcodes below, yes. For CONTENT_BLOCKED, not with the same content. If subcode is null, contact support first.

Why it happens

The subcode field gives the cause, and action says what to do: If subcode is null, action is contact_support. Wavix can add delivery error codes. Treat a code you don’t recognize as this error.

How to fix it

  • TEMPLATE_INVALID: Check that name, language, placeholders, header, and buttons in the message match the template returned by List WhatsApp templates.
  • MEDIA_UNSUPPORTED: Send the media in a different file format.
  • MEDIA_INVALID: Check that the media url is a public https URL that returns the file and stays reachable until the message is delivered.
  • CONTENT_BLOCKED: Change the content so that it follows the WhatsApp policies.
  • Other subcodes, or null: Contact support@wavix.com. Include the message ID (uuid, or message_uuid in the event).
After you fix it, send the message again as a new request with a new idempotency_key.

Technical details

For the error format and how to handle it, see WhatsApp delivery errors.