Publish to Instagram
Publish images and videos directly to an Instagram account. The product type is auto-detected from the media format.
POST
/api/v1/publish/instagramRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| mediaId | string | Yes | Media ID to publish |
| instagramAccountId | string (UUID) | Yes | The connected Instagram account ID |
| caption | string | No | Post caption (max 2200 characters) |
| altText | string | No | Alt text for accessibility (max 1000 characters) |
| product | string | No | "IMAGE" | "REELS" | "STORIES". Auto-detected: images default to IMAGE, videos default to REELS |
| shareToFeed | boolean | No | Share a Reel to the main feed as well |
Response
The operation is asynchronous. The initial response returns an outputJobId and a status of queued. Poll GET /jobs/publish/{outputJobId} until the status reaches a terminal value (succeeded or failed).
{
"outputJobId": "oj_...",
"status": "queued"
}Example
POST
/api/v1/publish/instagram{
"mediaId": "media_abc",
"instagramAccountId": "550e8400-e29b-41d4-a716-446655440000",
"caption": "Check out this new video!",
"shareToFeed": true
}