Instagram Business Settings

OpenQuok public API provider settings for Instagram Business (FB-linked) — post type, trial reels, collaborators, and follow-up comments.

2 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Start for $0

Quick reference

Property	Value
Identifier	instagram-business
Connect	GET /api/v1/public/social/instagram-business (+ Facebook Page picker)
Setup guide	Instagram
Character cap	2,200
Main-post media	≥1 attachment required for status: scheduled; story/trial reel = 1 item; carousel ≤10

Note

instagram-business and instagram-standalone accept the same settings shape — only the connect path differs. Standalone (IG Login) docs: Instagram Standalone Settings.

Settings on create post

Flat keys merge into providerSettingsByIntegrationId[<integration-id>]. Follow-up comments nest under instagram.replies.

Flat CLI / API key	Nested composer bucket	Purpose
post_type	instagram.postType	Feed/Reel vs story
is_trial_reel	instagram.isTrialReel	Trial Reel (single video, feed only)
graduation_strategy	instagram.graduationStrategy	MANUAL or SS_PERFORMANCE when trial reel is on
collaborators	instagram.collaborators	Up to 3 IG usernames (feed/Reel single media only)
—	instagram.replies	Text follow-up comments

{
  "providerSettingsByIntegrationId": {
    "<instagram-integration-id>": {
      "post_type": "story",
      "collaborators": [{ "label": "openquok" }],
      "instagram": {
        "replies": [
          { "message": "Thanks for the love!", "delaySeconds": 300 }
        ]
      }
    }
  }
}

Field reference

Field	Type	Required	Notes
post_type	string	No	Omit or post for feed/Reel; story for Stories
is_trial_reel	boolean	No	Single MP4 trial reel — not combinable with Stories
graduation_strategy	string	No	Used when is_trial_reel is true; defaults to MANUAL
collaborators	array	No	Strings or { label } objects; max 3; not on Stories or carousels
instagram.replies	array	No	Comments on the published media
instagram.replies[].message	string	Yes (per row)	Text only — no media on follow-ups
instagram.replies[].delaySeconds	number	Yes (per row)	Delay after previous part

Follow-up comments

Instagram follow-ups use instagram.replies — text only. Put images and video on the main post media array.

Complete example

Upload media first, then schedule a feed post:

# 1) Upload
curl -X POST https://api.openquok.com/api/v1/public/upload 
  -H "Authorization: Bearer opo_your_programmatic_token" 
  -F "[email protected]"

# 2) Schedule
curl -X POST https://api.openquok.com/api/v1/public/posts 
  -H "Authorization: Bearer opo_your_programmatic_token" 
  -H "Content-Type: application/json" 
  -d '{
    "body": "Beautiful sunset #photography",
    "scheduledAt": "2026-05-15T18:00:00.000Z",
    "status": "scheduled",
    "integrationIds": ["<instagram-integration-id>"],
    "isGlobal": true,
    "media": [{ "id": "img-123", "path": "FILE_PATH_FROM_UPLOAD" }]
  }'

Publish a Story (one attachment; collaborators are not supported on Stories):

{
  "body": "",
  "scheduledAt": "2026-05-15T18:00:00.000Z",
  "status": "scheduled",
  "integrationIds": ["<instagram-integration-id>"],
  "isGlobal": true,
  "media": [{ "id": "img-123", "path": "FILE_PATH_FROM_UPLOAD" }],
  "providerSettingsByIntegrationId": {
    "<instagram-integration-id>": {
      "post_type": "story"
    }
  }
}