Skip to main content

Facebook

To be able to post on Facebook and Instagram, you must create and configure a Facebook application. Because Facebook and Instagram belong to the same company Meta.

Step 1: Create a Developer Account

To create a Facebook app, you must first have a Facebook developer account. If you don't already have one, go to the Facebook for Developers website and click "Get Started" in the top right corner. Follow the instructions to sign up for a developer account.

Step 2: Create a New App

Once you have a developer account, go to the Facebook Developer Dashboard and click "Create App" in the top right corner. Choose "Business" as the app type and give your app a name.

1.png

1.1.png

2.png

3.png

Step 3: Configure Basic Settings

After creating your app, you'll be taken to the app dashboard. Here, you can configure your app's basic settings, such as the app icon and description. You'll also need to configure the "App Domains" and "Privacy Policy URL" settings.

With Mixpost you can generate Terms, Privacy policy pages in seconds. 
Navigate to "Admin Console -> Pages" and click on the right-top "Generate Samples" button.

4.png

Step 4: Copy the App ID and App Secret to Mixpost

After creating the App, you will see the App ID and hidden App Secret. Copy them, open your Mixpost dashboard, and paste the keys to the Facebook third-party service form.

  • Mixpost Lite: From the left sidebar->Services.
  • Mixpost Pro/Enterprise: User Menu->Admin Console->Services

fb-third-party-service-form.png

Select the version of your Facebook application: Your Facebook app->Settings->Advanced

Select the version of your Facebook application

Step 5: Setting callback links

Next, you need to do some essential configurations.

  1. On the left sidebar, click on “Add product” and select “Facebook Login for Business.”

  2. Go to the “Valid OAuth Redirect URIs” input and enter these callback URLs:

  3. Click “Save changes”

10.png

Step 6: Testing

You can test your app by adding your Facebook account to the Mixpost. We recommend creating a few test posts using the app in Development and then switching to Live mode.

Accounts→Add account

Unfortunately, if you have version v19.0 of the Facebook application, you cannot connect groups because the Facebook Groups API is deprecated in this version. We are looking for a solution as quickly as possible.

Conclusion

Any data generated while an app is in Development mode, such as posts, can only be seen by role users. However, the data will be visible to non-role users once the app is switched to Live mode.

Your Facebook app can only request data from users with an app role. For users who do not have a role in the application, your Facebook app must have Advanced Access permissions.

Note that the app in Live mode can not post to Facebook groups. If posting to a group, requires your app to be installed in the group. Your app will be visible in the list of Facebook applications only if you have requested advanced access and it was successfully verified.

App Review (Advanced Access permissions)

If your app is used by app users who do not have a role on your app or a role in a Business that has claimed your app, you have to request approval for advanced access permissions via App Review. This step is recommended for those who have Mixpost Enterprise.

Note that Business Verification is required to gain advanced access.

Create a test user(non-admin) account from your Mixpost account. With this account, the Meta team will be able to test your application.

Navigate to "App Review > Permissions and Features"

9.png

If your Facebook App is using v19.0, you must request permissions for the following scopes:

  • business_management
  • pages_show_list
  • read_insights
  • pages_manage_posts
  • instagram_basic
  • instagram_content_publish
  • instagram_manage_insights

If your Facebook App is using v17.0, or v18.0, you must request permissions for the following scopes:

  • business_management
  • pages_show_list
  • read_insights
  • pages_manage_posts
  • publish_to_groups
  • instagram_basic
  • instagram_content_publish
  • instagram_manage_insights

If your Facebook App is using v16.0, you must request permissions for the following scopes:

  • pages_show_list
  • read_insights
  • pages_manage_posts
  • publish_to_groups
  • instagram_basic
  • instagram_content_publish
  • instagram_manage_insights

fb-app-verification-details.png

The text for "App Verification Details"

Testing email: meta-test@example.com

Testing password: test-password

To see how these permission are used in my app:

1. Navigate to https://your-domain.com

2. Login in using the credentials provided

3. Once you’ve accessed the website, click “Accounts” in the left sidebar.

4. Click on the “Add account” button

5. Click the “Facebook page”

6. Login with your Facebook account and accept all the permissions

7. Select your pages and click on the “Choose” button

8. Your Facebook pages have been added to my app. This way you can connect a Facebook page, Facebook Group, or Instagram account.

Then click on the "Save" button.

fb-app-verificiation-details-permission-description.png

Before submitting the app for review, it is essential to finish all the required steps and provide information for each requested permission. The "Submit for Review" button located at the bottom of the page will become active only when all the review requirements, indicated by blue checkmarks, are fulfilled.

It can take several days to get a response from Facebook. You can check your pending request in the Facebook developer account in the "App Review -> Requests" section.

Example instructions for every app review scope

It will be necessary to provide a detailed description and screen recording for each permission. Screen Recordings guide.

Useful information:

Scope

Use case description

What to show in the video

business_management

We need this permission to receive access to the business admin pages and display them to connect the chosen one to my app. 

 

To see how "business_management" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Page".
4. Facebook authorization will open in a new tab.
6. Login with your Facebook account and accept all the permissions.
7. Next, a list with available Facebook pages will open.
8. Select the Facebook page you want to connect to and connect it with my app by clicking the "Choose" button.
9. Now the Facebook page should be connected to my app.

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can add a Facebook page, accept the permission, select the pages from the list, and show the connected pages on the Accounts page.

pages_show_list

We need this permission to read and display the list of Pages a person manages to connect the chosen one to my app. 

 

To see how "pages_show_list" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. A login dialog will open, click on "Facebook Page".
3. Facebook authorization will open in a new tab.

4. A login dialog to Facebook will open in a new window.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list with available Facebook pages will open.
7. Select the Facebook page you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Facebook page should be connected to my app.

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can add a Facebook page, accept the permission, select the pages from the list, and show the connected pages on the Accounts page.

read_insights

We need this permission to read the insights data for Pages:

  • Daily Page Engaged Users

  • Daily Total Impressions of page posts

  • Daily Post Engagements of page.

This permission helps our users to understand what content is resonating with their audience and what to post to maximize their audience engagement.

 

To see how "read_insights" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Page".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list with available Facebook pages will open.
7. Select the Facebook page you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Facebook page should be connected to my app.

9. Click on the "Dashboard" button from the left menu and select the page you added. Here you will see all metrics. The data is collected by my app every 2 hours.

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can add a Facebook page, accept the permission, select the pages from the list, and show the connected pages on the Accounts page.

 

You must show the Mixpost Analytics page of a Facebook page.

pages_manage_posts

We need this permission to create content posted on the page (posts, videos, photos).

 

This permission is required for my app to provide users with the benefit of scheduling and publishing posts on their pages.

 

To see how "pages_manage_posts" are used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Page".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available pages will open.
7. Select the Facebook page you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Facebook page should be connected to my app.

9. Click on the top "CREATE POST" button from the left menu.

10. Select which page you want to post on.

11. Write whatever you want to share with your audience.

12. On the right bottom, click on the "Post now" button or you can pick a time to schedule. If you click "Post now" the post should be published in a minute to the selected page.

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can add a Facebook page, accept the permission, select the pages from the list, and show the connected pages on the Accounts page.

 

You must show how you are creating the post and publishing it. Also, show that after publishing you can open the original post on the Facebook site.

pages_read_engagement

We need this permission because it is required by "pages_manage_posts" permission. We need this permission to read content(posts, photos, videos) posted by the Page.

 

To see how "pages_read_engagement" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Page".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available pages will open.
7. Select the Facebook page you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Facebook page should be connected to my app.

9. Click on the top "CREATE POST" button from the left menu.

10. Select which page you want to post on.

11. Write whatever you want to share with your audience.

12. On the right bottom, click on the "Post now" button or you can pick a time to schedule. If you click "Post now" the post should be published in a minute to the selected page.

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can add a Facebook page, accept the permission, select the pages from the list, and show the connected pages on the Accounts page.

 

You must show how you are creating the post and publishing it. Also, show that after publishing you can open the original post on the Facebook site.

publish_to_groups

We need this permission to publish content (posts, videos, photos) into a group on behalf of a person who connected with his Facebook account in my app.

 

This permission is required for my app to provide users with the benefit of scheduling and publishing posts on their groups.

 

To see how "publish_to_groups" are used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Group".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available groups will open.
7. Select the group you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the group should be connected to my app.

9. Click on the top "CREATE POST" button from the left menu.

10. Select which group you want to post on.

11. Write whatever you want to share with your audience.

12. On the right bottom, click on the "Post now" button or you can pick a time to schedule. If you click "Post now" the post should be published in a minute to the selected group.

 

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You need to show how to add a Facebook group and how to create and publish a post to a group. Also, show that after publishing you can open the original post on the Facebook site.

Groups API

We need this permission because it is required by "publish_to_groups" permission. We need this permission to publish content (posts, videos, photos) into a group on behalf of a person who connected with his Facebook account in my app.

 

This permission is required for my app to provide users with the benefit of scheduling and publishing posts on their groups.

 

To see how "publish_to_groups" are used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Facebook Group".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available groups will open.
7. Select the group you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the group should be connected to my app.

9. Click on the top "CREATE POST" button from the left menu.

10. Select which group you want to post on.

11. Write whatever you want to share with your audience.

12. On the right bottom, click on the "Post now" button or you can pick a time to schedule. If you click "Post now" the post should be published in a minute to the selected group.

 

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You need to show how to add a Facebook group and how to create and publish a post to a group. Also, show that after publishing you can open the original post on the Facebook site.

instagram_basic

We need this permission to read an Instagram Business account profile's info. We need to get the basic metadata of an Instagram Business account profile: ID, Username, Profile Picture, and number of followers.

 

To see how "instagram_basic" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Instagram".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available Instagram accounts will open.
7. Select the Instagram account you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Instagram account should be connected to my app.

9. Also, you can see the number of followers of your Instagram account by visiting the "Dashboard" page, from the left menu, then select your Instagram Account. Here you will see the Audience graph. Our app collects the number of followers every 3 hours.

 

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can connect an Instagram profile, accept the permission, select the Instagram profiles from the list, and show the connected profiles on the Accounts page.


Also, show only the Audience graph.


instagram_content_publish

After the user adds an Instagram profile to my app, we need this permission to allow users to publish photo and video posts on behalf of a connected Creator/Business Instagram account profile.

 

This permission is required for my app to provide users with the benefit of scheduling and publishing posts on Instagram.

 

To see how "instagram_content_publish" is used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Instagram".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available Instagram accounts will open.
7. Select the Instagram account you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Instagram account should be connected to my app.

9. Click on the top "CREATE POST" button from the left menu.

10. Select which Instagram account you want to post on.

11. Write whatever you want to share with your audience.

12. Upload an image or a video from the editor menu. (the second button)

13. On the right bottom, click on the "Post now" button or you can pick a time to schedule. If you click "Post now" the post should be posted in a minute to the selected Instagram account.

 

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can connect an Instagram profile, accept the permission, select the Instagram profiles from the list, and show the connected profiles on the Accounts page.

 

You must show how you are creating the post/reel and publishing it. Also, show that after publishing you can open the original post on the Instagram site.

instagram_manage_insights

We need this permission to access insights for the Instagram Business account profile. By accessing these insights, we can provide our users with metrics like reach, impressions, profile views, phone call clicks, and more. It helps users to understand what content is resonating with their audience and what to post to maximize their audience engagement.

 

By being granted the 'instagram_manage_insights' permission, our app can offer users a comprehensive, detailed, and valuable view of their Instagram Business account performance.

 

To see how "instagram_manage_insights" are used in my app:

1. Inside my app, click "Accounts" from the left menu.

2. Click on the "Add Account" button.

3. A login dialog will open, click on "Instagram".
4. Facebook authorization will open in a new tab.
5. Login with your Facebook account and accept all the permissions.
6. Next, a list of available Instagram accounts will open.
7. Select the Instagram account you want to connect to and connect it with my app by clicking the "Choose" button.
8. Now the Instagram account should be connected to my app.

9. Click on the "Dashboard" button from the left menu and select the Instagram account you added. Here you will see all metrics. The data is collected by my app every 2 hours.

 

You can test it here:
- URL: https://your-domain.com
- email: meta-test@example.com
- password: test-password

You must show how a user can connect an Instagram profile, accept the permission, select the Instagram profiles from the list, and show the connected profiles on the Accounts page.

 

You must show the Mixpost Analytics page of an Instagram profile.