Skip to main content

Create a template with a media header

Meta asks for a sample of the header when you create the template. Upload the sample file and pass the returned handle as header_handle:
JPEG and PNG up to 5 MB, MP4 up to 16 MB, PDF up to 29 MB. From your backend, send the file as a multipart part named file, or a public https link as JSON {"sourceUrl": "https://..."}. The response carries handle (API reference):
With a channel access token, use Meta’s resumable upload flow through the gateway. Start a session, then post the bytes to the returned id, unchanged. The h in the response is the handle:
In the first call, app can also be your channel’s own numeric Meta app id, as Meta’s docs show it. Any other app id is refused.