Upload media
Uploads one file as multipart/form-data and appends it to the post’s media. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). A type the post’s channel does not accept fails with 422: This file type is not supported by the post's channel. Posts that are publishing, published or failed cannot take media: 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. On Pinterest and TikTok the content type is chosen again from the post’s media, as on create. An X poll (x_poll) takes no media: 422 on media with This post type can't include media. Change the post type to add media.
Response
The post with the new media.
A post on one channel. Posts created together from several channels are independent posts that share a post_group_id.
Publishing state on the network. pending until the post is sent; retrying waits for a retry after a network limit or a temporary network problem (such as a LinkedIn post not yet ready for its comment); pending_review and rejected come from networks that review posts (Google Business).
pending, publishing, retrying, pending_review, published, failed, rejected Post format on one network. It must belong to the destination's network. GET /content-types lists the formats of each network with their media rules. Instagram and Facebook stories publish no text. An X poll (x_poll) takes no media; its choices and length are in meta.poll.
instagram_feed, instagram_reel, instagram_story, linkedin_post, linkedin_page_post, facebook_post, facebook_reel, facebook_story, tiktok_video, tiktok_photo, youtube_short, x_post, x_poll, threads_post, threads_ghost_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message, google_business_post 
