Instagram

Configure the OwlStack WordPress plugin to publish posts to your Instagram Business or Creator account.

Prerequisites

You need an Instagram Business or Creator account connected to a Facebook Page, and a valid Instagram Graph API access token.

Getting Instagram API Credentials

Convert your Instagram account to a Business or Creator account
Connect it to a Facebook Page
Go to Meta for Developers and create an app
Use the Graph API Explorer to get your Access Token
Query me/accounts to find your Page, then use the Page token to get your Instagram Account ID via {page-id}?fields=instagram_business_account

Account Type Required

The Instagram API only works with Business or Creator accounts. Personal accounts are not supported.

Settings

Navigate to OwlStack > Instagram in the WordPress admin.

Field	Description
Access Token	A valid Instagram Graph API access token
Instagram Account ID	Your Instagram Business Account's numeric ID

Step-by-step

Go to OwlStack > Instagram in your WordPress admin
Paste your Access Token
Enter your Instagram Account ID
Click Save Settings

Testing

After saving your settings:

Click Test Connection to verify your access token and account ID
Click Send Test Message to publish a test post
Check your Instagram profile to confirm the post appeared

Publishing

Once configured, Instagram appears as a toggle in the OwlStack meta box on post edit screens.

Programmatic publishing

// Post with an image (required for Instagram)
owlstack()->instagram('Hello from WordPress!', [
    'type' => 'photo',
    'url'  => 'https://example.com/image.jpg',
]);

Image Required

Instagram requires at least one image or video for every post. Text-only publishing is not supported by the Instagram API.

Constraints

Constraint	Value
Max caption length	2,200 characters
Max images per carousel	10
Supported image types	JPEG, PNG
Max image size	8 MB
Supported video types	MP4, MOV
Max video duration	60 seconds (feed), 90 seconds (Reels)

Troubleshooting

Issue	Solution
"Invalid access token"	Token may have expired; generate a new one
"Account not found"	Verify the Instagram Account ID is the business account ID, not the Page ID
"Media required"	Instagram does not support text-only posts; include an image or video
"Permission denied"	Ensure your app has `instagram_basic` and `instagram_content_publish` permissions

Instagram

On this page