Skip to contentSkip to navigationSkip to topbar
Page toolsOn this pageProducts used
Looking for more inspiration?Visit the

63045: Link to a sample media file returned an unexpected error status


ERROR: 63045

error-63045 page anchor
MESSAGING
ERROR

This error occurs when Twilio tries to download the sample media file and the URL returns an unexpected HTTP status code, so Twilio cannot retrieve the file. For media templates that you submit for WhatsApp approval, the sample media URL must resolve to a publicly hosted media file. If you use a variable in the media URL, the sample value must complete the path and include a valid file suffix.

Possible causes

possible-causes page anchor
  • The sample media URL is incorrect or contains whitespace characters.
  • The file is not publicly accessible, or the hosting server is not returning the media file successfully.
  • The URL resolves to a preview page or another intermediate page instead of the media file itself. Google Drive links are not supported for sample media because they do not resolve directly to the file.
  • The sample value for a variable media URL does not complete the full path after the domain or does not include the file type suffix.
  • The host does not respond correctly to the validation requests Twilio sends to inspect media resources. Twilio uses GET and HEAD requests to validate media.
  • Confirm that the sample media URL is correct and does not contain whitespace.
  • Open the URL in your browser and verify that it returns the media file itself, not a preview page or redirect landing page.
  • Host the file at a publicly accessible URL that Twilio can download during sample submission.
  • If you use a variable in the media URL, provide a sample value that completes the full path and includes a valid file extension such as .png or .pdf.
  • If the file is hosted on Google Drive or a similar service, move it to a host that returns the media file directly.
  • Check that your host responds successfully to GET and HEAD requests and returns the correct Content-Type for the file.

Additional resources

additional-resources page anchor