PUpublora
Media

Upload a custom Instagram Reel cover image

Upload a cover image for an Instagram Reel. The image is stored as a JPEG (PNG/WebP are transcoded server-side; transparency is flattened onto white) and a public URL is returned. Set that URL as platformSettings.instagram.coverUrl via update-post to use it as the Reel cover. The target post group must be an editable (draft or scheduled) post you own and not currently publishing. Covers apply to Reels only and are ignored for Stories and images.

post/upload-instagram-cover

Request

  • Base URL
    https://api.publora.com/api/v1
  • Auth
    API key in header x-publora-key

Headers

x-publora-user-idstring

Managed user ID (workspace only)

Request body multipart/form-data

coverstring binary required

Cover image (JPEG, PNG, or WebP; 8 MB max). PNG/WebP are converted to JPEG.

postGroupIdstring required

Editable post group (draft or scheduled) to attach the cover to

Example request

{
  "postGroupId": "507f1f77bcf86cd799439011"
}

Response

Cover uploaded

successboolean
messagestring

Example response

{
  "success": true,
  "cover": {
    "mediaId": "665f8a1b2c3d4e5f6a7b8c9d",
    "url": "https://media.publora.com/images/665f...-reel-cover.jpg"
  }
}

Changes

No recorded changes to this operation across all 13 revisions of this API.