Skip to content
Dashboard

Get a planned Instagram post

GET
/instagram/posts/{id}
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.

id
required
string

A planned post (from listInstagramPosts or createInstagramPost).

The planned post

Media typeapplication/json
object
data
object
id
string
account_id
string
nullable
account_username
string
nullable
kind
string
Allowed values: image carousel reel story
caption
string
media
Array<object>
object
type
string
Allowed values: image video
url

The URL given through the API; null for a file uploaded from the dashboard.

string
nullable
status
string
Allowed values: scheduled publishing reminded published failed
publish_at
string format: date-time
published_at
string format: date-time
nullable
permalink
string
nullable
instagram_media_id
string
nullable
error_code
string
nullable
automation

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
keyword
string
message
string
first_comment

Posted one step after the post is live; a failure never takes the post back.

object
message
string
status
string
Allowed values: pending posted failed
error_code

Comment_needs_reconnect, account_restricted, comment_refused, comment_gave_up, comment_no_media

string
nullable
trial

A trial reel (shown first to non-followers).

boolean
collaborators
Array<string>
user_tags
Array<object>
object
username
string
x
number
y
number
alt_texts

Each media’s alternative text

Array<string>
audio_name
string
nullable
share_to_feed
boolean
comments_enabled

False when the comments are turned off once it is live.

boolean
mode
string
Allowed values: auto remind
reminded_at

When the person was reminded (mode remind).

string format: date-time
nullable
facebook

The copy on the linked Facebook Page; its outcome never touches the Instagram post’s.

object
status
string
Allowed values: pending publishing published failed cancelled
page_name
string
permalink
string
nullable
published_at
string format: date-time
nullable
error_code

Fb_permission, fb_reconnect, fb_reel_limit, fb_reel_duration, fb_reel_ratio, fb_photo_refused, fb_carousel_video, fb_processing_timeout, fb_unconfirmed…

string
nullable
source
string
Allowed values: app api
created_at
string format: date-time
nullable
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

Media typeapplication/json
object
error
object
code
string
message
string
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)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Resource not found in this workspace

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}