Get a planned Instagram post
const url = 'https://app.whatsetter.com/api/v1/instagram/posts/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://app.whatsetter.com/api/v1/instagram/posts/example \ --header 'Authorization: Bearer <token>'One post planned through WhatSetter, to follow it after
POST /instagram/posts: its status, its permalink once published,
its first comment, and its copy on the Facebook Page (facebook: its
own status, permalink and error_code). A cancelled post, or one of
another workspace, answers 404. Requires scope instagram:read.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”A planned post (from listInstagramPosts or createInstagramPost).
Responses
Section titled “Responses”The planned post
object
object
object
The URL given through the API; null for a file uploaded from the dashboard.
The comment automation made on the post once it is live. A post planned in the dashboard may carry a whole automation built in its editor (link, follow ask, who continues…): it is summed up here as its first word (empty when it answers every comment) and its private message. Sending automation replaces it with this simple shape.
object
Posted one step after the post is live; a failure never takes the post back.
object
Comment_needs_reconnect, account_restricted, comment_refused, comment_gave_up, comment_no_media
A trial reel (shown first to non-followers).
object
Each media’s alternative text
False when the comments are turned off once it is live.
When the person was reminded (mode remind).
The copy on the linked Facebook Page; its outcome never touches the Instagram post’s.
object
Fb_permission, fb_reconnect, fb_reel_limit, fb_reel_duration, fb_reel_ratio, fb_photo_refused, fb_carousel_video, fb_processing_timeout, fb_unconfirmed…
Example
{ "data": { "kind": "image", "media": [ { "type": "image" } ], "status": "scheduled", "first_comment": { "status": "pending" }, "mode": "auto", "facebook": { "status": "pending" }, "source": "app" }}Missing, unknown or revoked API key
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}