gitroomhq · egelhaus · Jun 9, 2025 · Jun 6, 2025 · Jun 6, 2025 · Jun 6, 2025
diff --git a/pages/providers/facebook.mdx b/pages/providers/facebook.mdx
@@ -12,28 +12,28 @@ import OAuth2Redirect from "../../components/snippets/oauth2redirect.tsx";
 
 <Steps>
 ### Step 1
-Create a [new app in Facebook developers](https://developers.facebook.com/apps/creation/), choose the business you want to connect it to.<br />
-Please be advised that for public applications you would need to verify you business.
+Select a business portfolio, then create a [new app in Facebook developers](https://developers.facebook.com/apps/creation/).<br />
+Please be advised that for public applications, you will need to verify your business.
 
-![Create app](https://github.com/user-attachments/assets/e24f15a7-d9b1-48cb-8952-7a5258923b4c)
+![Business Portfolio](https://i.imgur.com/o5QIKox.png)
+
+![Create app](https://camo.githubusercontent.com/5810cacc269b9fcaf7951a4e3bf0aa7eb66fa27d571e516dbbbf4e967f9c2021/68747470733a2f2f692e696d6775722e636f6d2f795274305a44492e706e67)
 
 ### Step 2
 Select "Other" and click next
 
-![Other](https://github.com/user-attachments/assets/9c976b82-0b73-4d1d-b3ef-cf98e4cc0c50)
+![Other](https://camo.githubusercontent.com/a78fd51034a50459f6eb922d5e4feae99db28e1793d3e408869976f2b5290dbe/68747470733a2f2f692e696d6775722e636f6d2f4d315234614f662e706e67)
 
 ### Step 3
 Then select business
 
 ![Business](https://github.com/user-attachments/assets/74bde861-5441-46bb-b5b8-c5229e980237)
 
+### Step 4
 Add all your details and click Create App
 
-### Step 4
 ![CleanShot 2024-09-24 at 13 45 54](https://github.com/user-attachments/assets/f0c03825-0f9b-4467-94a4-ab8cf6ed7e1d)
 
-Set final details
-
 ### Step 5
 ![Setup Login with Facebook](https://github.com/user-attachments/assets/08d3c1d1-d498-49d1-adac-aa6248e7c10c)
 

diff --git a/pages/providers/instagram.mdx b/pages/providers/instagram.mdx
@@ -11,35 +11,36 @@ import OAuth2Redirect from "../../components/snippets/oauth2redirect.tsx";
 </Callout>
 
 ## Connection Options
-There are two ways to connect to an Instagram account: by using a Facebook Business or through a standalone flow that connects directly to an Instagram account. 
+There are two ways to connect to an Instagram account: by using a Facebook Business or through a standalone flow that connects directly to an Instagram account. Both methods will require a [Meta for Developpers account](https://developers.facebook.com/apps/).
 
 ## Setting up Meta Application
 
 The following steps will guide you through the setup of a Meta application that can be used for connecting Instagram to Postiz.
 
 <Steps>
 ### Step 1
-Create a [new app in Instagram developers](https://developers.instagram.com/apps/creation/), choose the business you want to connect it to.<br />
-Please be advised that for public applications you would need to verify you business.
+Select a business portfolio, then create a [new app in Meta for developers](https://developers.facebook.com/apps/creation/).<br />
+Please be advised that for public applications, you will need to verify your business.
 
-![Create app](https://github.com/user-attachments/assets/e24f15a7-d9b1-48cb-8952-7a5258923b4c)
+![Business Portfolio](https://i.imgur.com/o5QIKox.png)
+
+![Create app](https://i.imgur.com/yRt0ZDI.png)
 
 ### Step 2
 Select "Other" and click next
 
-![Other](https://github.com/user-attachments/assets/9c976b82-0b73-4d1d-b3ef-cf98e4cc0c50)
+![Other](https://i.imgur.com/M1R4aOf.png)
 
 ### Step 3
 Then select business
 
 ![Business](https://github.com/user-attachments/assets/74bde861-5441-46bb-b5b8-c5229e980237)
 
+### Step 4
 Add all your details and click Create App
 
-### Step 4
-![CleanShot 2024-09-24 at 13 45 54](https://github.com/user-attachments/assets/f0c03825-0f9b-4467-94a4-ab8cf6ed7e1d)
+![Create an app details page](https://github.com/user-attachments/assets/f0c03825-0f9b-4467-94a4-ab8cf6ed7e1d)
 
-Set final details
 </Steps>
 
 ## Facebook Business Option
@@ -94,7 +95,7 @@ If you want to connect directly to your Instagram account without having to use
 
 <Steps>
 ### Set up Instagram
-![Instagram](/images/providers/instagram-standalone/instagram-standalone-001.png)
+!["Add products to your app" section of app creation](/images/providers/instagram-standalone/instagram-standalone-001.png)
 
 Set up Instagram.
 
@@ -122,3 +123,33 @@ INSTAGRAM_APP_SECRET="app secret"
 
 Go to the Postiz web interface, and click on the "Add Channel" button. Select "Instagram (Standalone)" from the list of available channels. You should be redirected to the Instagram login screen to authorize the application.
 </Steps>
+
+## Adding App Roles
+
+If you're having trouble connecting to your Instagram accounts, adding them as App Roles may help.
+
+<Steps>
+### Go to the App Roles page
+
+![Facebook App developpers dashboard](https://i.imgur.com/XPDtMvg.png)
+
+### Add a role
+
+Click on "Add People"
+
+![App Roles page](https://i.imgur.com/ZdIDGYf.png)
+
+### Add an Instagram Tester
+
+Select the "Instagram Tester" option, and type in the handles of all the Instagram accounts you'd like to connect to. Then, click "Add".
+
+![Add people window](https://i.imgur.com/VqF4xDJ.png)
+
+### Accept the invitations
+
+Go to your Instagram account, and accept the tester invitation in the [Apps and Websites section of the profile settings](https://www.instagram.com/accounts/manage_access/).
+
+![Apps and Websites section of the profile settings](https://i.imgur.com/zODkmtD.png)
+
+</Steps>
+
diff --git a/pages/providers/threads.mdx b/pages/providers/threads.mdx
@@ -13,12 +13,13 @@ This is a complex integration, and it may take some time to get it right. If you
 </Callout>
 
 <Steps>
-### Create an app
+### Create an app from from Meta Business Suite / Business Manager
 
-Go to the [Meta/Facebook Developer Portal](https://developers.facebook.com/apps) and click on "Create app".
+Go to [Settings](https://business.facebook.com/latest/settings/apps) in Meta Business Suite or Business settings in Business Manager. Click "Add" and create a new app ID:
 
-![Create app](./threads_create_app.png)
+![Create a new app ID](https://i.imgur.com/lldjHmc.png)
 
+You'll be redirected to Meta for Developpers.
 
 ### Give your app a name and email
 
@@ -32,7 +33,7 @@ Select *Access the Threads API*.
 
 ### Add business details, or skip
 
-![Add business details](./threads_business.png)
+![Add business details](https://i.imgur.com/M2Yal5A.png)
 
 ### Finish creating the app