Instagram — Connect it to MokonyxSocial

Connecting Instagram lets MokonyxSocial post your images and videos to your Instagram account automatically. One important thing up front: Instagram's system is built around pictures, so every post needs an image or video — plain text posts aren't possible here.

What you need

• An Instagram professional account (a Business or Creator account — a regular personal account won't work). You can switch to one for free in the Instagram app settings.
• That Instagram account connected to a Facebook Page.
• A free Meta developer app (this is the piece that gives permission to post). We'll walk through it below.

Heads up: this is the most technical of the connections, and Meta may ask you to submit your app for review before it will post to a live account. If any step feels over your head, this is a good one to hand to your developer.

Get your credentials

Access Token access_token (required)

This is the key that lets MokonyxSocial post to your Instagram for you.

1. Go to https://developers.facebook.com and sign in with the Facebook account that manages your Page.
2. Click My Apps → Create App, and pick the Business option.
3. In your new app, choose Add Product and add Instagram.
4. Open Tools → Graph API Explorer (https://developers.facebook.com/tools/explorer). Pick your app, choose User Token, and turn on these permissions:

• instagram_basic
• instagram_content_publish
• pages_show_list
• pages_read_engagement

1. Click Generate Access Token and approve the login prompt.
2. That first token only lasts about an hour, so you'll want the long-lived version (about 60 days). Your developer can swap it using Meta's token-exchange step, or you can follow Meta's "long-lived token" guide.
3. Paste the long-lived token into the Access Token box. Mark your calendar to refresh it about every 60 days.

Instagram User ID ig_user_id (required)

This is a number that identifies your Instagram account (it's *not* your @username).

1. First get your Facebook Page ID — it's on your Page's About section.
2. In the Graph API Explorer, look up the Instagram account attached to that Page by requesting the instagram_business_account field for your Page.
3. The number it returns is your ig_user_id. Copy that into the field.

If this part is fiddly, ask your developer to run the one lookup — it takes them a minute.

Set it up in MokonyxSocial

1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Instagram.
3. Enter the credentials from the section above.
4. Click Send Test to verify the connection, then Save & Close and ensure the service is Published.

Verify

• Send Test should turn green and show your Instagram account name.
• Post one of your Joomla items that has a photo, then check your Instagram feed — it should appear shortly.

Troubleshooting

• It can't find your account — double-check the ID is the Instagram *Business Account* number and that your account is a professional account linked to your Page.
• It worked before and now stopped — your token probably expired (they last about 60 days). Generate a fresh long-lived one.
• "Media could not be fetched" — the picture or video needs to be publicly viewable on the web; make sure the image on your site isn't hidden or behind a login.
• It won't let you publish yet — Meta may require you to submit the app for review before posting to a live account.

Notes & limits

• Every post needs an image or video — no text-only posts.
• You can post single photos, videos, and carousels (multi-image posts).
• Instagram allows about 25 posts per day per account.
• The access token expires roughly every 60 days, so plan to refresh it.