---
title: "Upload a custom Instagram Reel cover image"
method: POST
path: "/upload-instagram-cover"
tags: ["Media"]
---

# Upload a custom Instagram Reel cover image

`POST /upload-instagram-cover`

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.

## Headers

- `x-publora-user-id` string

## Response `200`

Cover uploaded

- object
  - `success` boolean
  - `cover` object
    - `mediaId` string — Cover media record ID
    - `url` string, uri — Public JPEG URL — set as platformSettings.instagram.coverUrl via update-post
  - `message` string

## Other responses

- `400` — Invalid request
- `401` — Invalid API key
- `404` — Post group not found
- `409` — Post group is currently publishing
- `500` — Server error

---

[API](https://skmtc.dev/publora/apis/publora-api.md) · [All operations](https://skmtc.dev/publora/apis/publora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/publora/publora-api/revisions/a1534a88d80a/schema)