How To Connect Instagram To YACSS
Instagram uses the Facebook Developer Portal to manage API access. By creating a Facebook Developer App with Instagram permissions, you can connect your Instagram account to YACSS and publish content directly from your workflows.
Open Cloud Connectivity
In YACSS, navigate to Cloud Connectivity from the sidebar. Click Connect on the Instagram card to begin the setup process.
Prepare Your Inputs
You will need two credentials from the Facebook Developer Portal:
- Instagram App ID — Found in your Facebook Developer app settings
- Instagram App Secret — Found in your Facebook Developer app settings
We will retrieve both of these from the Facebook Developer Portal in the steps below.
Create Your App
Go to the Facebook Developer Portal and create your developer account if you haven't already. Navigate to My Apps, click Create App, then enter your App name and contact email and click Next.
developers.facebook.com/apps
Select Use Case
In the Use Cases step, click All in the left filter panel, then select Manage messaging & content on Instagram and click Next.
Connect Business Portfolio
Facebook will ask which Business Portfolio to connect. If you already have one, select it and click Next. Otherwise, Facebook will show no businesses available — click Business Settings to create one.
Create a Business Portfolio
Once created, return to the app creation screen, select your new portfolio, and continue.
Select Portfolio & Finish App Creation
Back on the app creation screen, select your business portfolio and click Next. Continue clicking Next through the remaining steps until your app is fully created.
Customize the Instagram Use Case
Once your app is created, go to Use Cases in the sidebar. Click Customize next to "Manage messaging & content on Instagram".
Add Required Permissions
Go to Permissions and features and add the following two permissions by clicking + Add next to each:
- instagram_business_basic — Allows reading Instagram Business account info and media
- instagram_business_content_publish — Allows creating organic photo and video posts on behalf of a business user
Set Up Business Login
Go back to Customize use case and click Set up under "Set up Instagram business login".
Add OAuth Redirect URL
A popup will appear asking for a Redirect URL. Paste the URL below and click Save.
https://app.yacss.site/user/instagram-redirect.php
Go to Roles & Add Instagram Tester
Navigate to App Roles → Roles in the sidebar. This is the Instagram account you actually want to post to. Click the Instagram Testers tab, then click Add People.
Enter Instagram Username
In the popup, select Instagram Tester as the role, then enter the username of the Instagram account you want to post to and click Add.
Accept the Tester Invite on Instagram
The invite will be pending until accepted. Log in to Instagram, go to Settings → App Website Permissions → Apps and Websites. Click the Tester Invites tab and click Accept.
Copy Instagram App ID & App Secret
The account is now connected as a tester. Go back to your app in the Facebook Developer Portal. Under API setup with Instagram login, copy both the Instagram App ID and Instagram App Secret — click Show to reveal the secret.
Paste Into YACSS & Allow Access
Return to YACSS. Paste your App ID and App Secret into the Instagram Account fields and click Save. You will be redirected to Instagram for authorization — click Allow to grant YACSS permission to view your profile, access media, and publish content.
