Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI

On this pageProducts used
Looking for more inspiration?Visit the
Error
Carrier error

63029: The receiver failed to download the template

Twilio Messaging DocumentationMessaging
Twilio WhatsApp Business Platform DocumentationWhatsApp
Twilio Content DocumentationContent

Description

description page anchor

This error occurs when the recipient cannot download a WhatsApp template. For WhatsApp messaging, this condition corresponds to WhatsApp error 2002. If your template includes media or URL-based actions, verify that each referenced resource is public and reachable before you retry the message.

Possible causes

possible-causes page anchor
  • The recipient's device or WhatsApp client could not download the template.
  • A media template references a file that is not publicly hosted, does not resolve correctly, or uses a file type that is not supported for WhatsApp templates.
  • A template button URL does not resolve to a publicly accessible website.
  • The destination number or handset could not receive the template successfully at the time of delivery.
  • Check the destination number and handset, then retry the message.
  • If the template includes media, host the file at a public URL, confirm the URL resolves successfully, and use a supported WhatsApp template media type such as JPG, JPEG, PNG, PDF, or MP4.
  • If the template includes a URL button, make sure the URL resolves to a publicly accessible website. If the URL uses variables, provide a valid sample path in the template.
  • Send templated WhatsApp messages with ContentSid and ContentVariables. Confirm the template is approved and configured correctly before you send it.
  • If you need a delivery fallback after a failed WhatsApp attempt, configure channel fallback to SMS and include both the recipient's phone number and WhatsApp address.

Additional resources

additional-resources page anchor