Instagram Integration | Documentation

Publish photos, carousels, Reels, and Stories to an Instagram Business or Creator account. Instagram connects through Facebook, because that is the only way Meta allows third-party publishing.

At a glance

What it's for	Photos, carousels, Reels, and Stories.
Post types	Image, Video, Story
Account needed	An Instagram Business or Creator account linked to a Facebook Page. Personal Instagram accounts cannot publish through any third-party tool — this is Meta's rule, not ours.
How you connect	OAuth through Facebook — you approve the Page, and the linked Instagram account comes with it.
Content archiving	Published posts are backed up automatically.

Connecting your account

Before you start, your Instagram account must be a Business or Creator account and it must be linked to a Facebook Page you administer. You can switch account types in the Instagram app under Settings, then link the Page from the same screen.

Then add Instagram from your Accounts page. You'll approve the connection on Facebook, and the linked Instagram account comes across with it. If Instagram doesn't appear after approving, the Page link is usually the reason — check it in the Instagram app and reconnect.

Personal Instagram accounts cannot publish through Greenwood Social, or through any other scheduling tool. Meta does not offer an API for them.

What you type, and where it shows up

Instagram posts have one text field — the caption — and no title. If you're sending the same post to YouTube or TikTok as well, your Title is used there and simply skipped here. The one exception: if you leave Content empty, the Title becomes the caption so the post isn't published blank.

A Instagram image post. Fields marked * are required.

You type	Image post	Video post	Story post
Title	No title field. Used as the post text only when Content is empty.	No title field. Used as the post text only when Content is empty.	No title field. Used as the post text only when Content is empty.
Content	The caption.max 2,200 characters	The caption.max 2,200 characters	The caption.max 2,200 characters
Tags	Appended as #hashtags to the caption.max 30 hashtags	Appended as #hashtags to the caption.max 30 hashtags	Appended as #hashtags to the caption.max 30 hashtags
Link	Not used — URLs in a caption are not clickable on this platform.	Not used — URLs in a caption are not clickable on this platform.	Not used — URLs in a caption are not clickable on this platform.
Privacy	Sets the post's visibility where Instagram allows it.	Sets the post's visibility where Instagram allows it.	Sets the post's visibility where Instagram allows it.

Media requirements

Images per post	up to 10 (at least 1)
Image formats	JPG
Max image size	8.0 MB
Image dimensions	at least 320×320. Anything larger than 1080×1350 is resized down for you.
Video formats	MP4, MOV
Max video size	1.0 GB
Video length	at least 3 seconds, up to 15 minutes
If your file doesn't fit	We convert it for you where we can — images become JPG and video becomes MP4. Files we can't bring within these limits are reported before the post is scheduled, not after.

Instagram accepts any aspect ratio between 4:5 (tall) and 1.91:1 (wide). Images outside that range are reported before the post is scheduled. All video is published as a Reel.

Per-post options

Option	What it does	Default	Applies to
Enable Comments`commentEnabled`	Allow users to comment on this post	On	All post types
Share to Feed`shareToFeed`	Share Reels to main feed (not just Reels tab) for wider visibility	On	Video

These are the options Instagram exposes to partner tools through its API. Platforms often test new settings inside their own app long before opening them to tools like ours — when that happens the option simply isn't available to us until they publish it.

Scheduling

Schedule Instagram posts for any future time — see Scheduled Posting for how times, timezones, and cancellation work.

Metrics

Metric	Status
Likes & comments	Available
Views / plays	Available
Reach / impressions	Available
Follower count	Available
Shares / reposts / saves	Not offered by the platform
Comment text (needed to read & reply to comments)	Available

If reach or follower numbers are missing on an account you connected a while ago, reconnect it — the permission that supplies them was granted after that token was issued.

Where it works

In the app	Create a post or schedule one, and select this account. Bulk sessions work too.
API	Post and schedule through the REST API with the same fields shown above.
MCP (Claude, ChatGPT, and others)	Connect Greenwood Social as an MCP connector and ask your assistant to draft and schedule posts.