Skip to main content
POST
Create a media container (API key)
Use Authorization: Bearer hmok_... (an API key, or a dashboard session) instead of a channel token. Accepted scope is channel.manage. Delivery is at-least-once: don’t automatically retry after an ambiguous failure (timeout, dropped connection). Check the container’s status first to see whether it was already created. Create the container, poll its status until finished, then publish. Videos and reels can take minutes; a publish on a container that is still processing answers 409 and can be retried. If you need the raw Graph request, see the hmat_ gateway twin.

Authorizations

Authorization
string
header
required

Authorization: Bearer hmok_... API key or a dashboard session token

Path Parameters

ch
string
required

ch_ channel id

Body

application/json
mediaType
enum<string>
required
Available options:
IMAGE,
VIDEO,
REELS,
STORIES,
CAROUSEL
imageUrl
string
videoUrl
string
caption
string
coverUrl
string
altText
string
locationId
string
audioName
string
shareToFeed
boolean
thumbOffset
integer
Required range: x >= 0
children
object[]
userTags
object[]
trialParams
object

Response

Container created

channelId
string
required
containerId
string
required