How to Setup a Facebook API and Identity for Stitchz
Stitchz allows a Facebook Page Manager to share and manage posts on their Page. This means that in order to share on Facebook via Stitchz you must request a developer API key/secret and the appropriate permissions (scope). Follow the steps below to request an API key/secret and submit for review.
- Login Facebook with the account you plan to share posts.
- Go to the developers portal, click "My Apps", then click Create App. You'll be asked "What do you want your app to do?", select "Other" at the bottom, then click Next.
Figure 1
On the next screen, select "Business" as the app type and then click Next.
Figure 2
Enter your application name, contact email address, and select your Business Account. If you don’t have a business account yet, you can create one at a later step.
Figure 3
Depending on your account and application type, you must choose between Facebook Login and Facebook Login for Business. Based on your choice, follow the steps in the respective tab below.
- Add the Facebook Login product to your new app by clicking on Set Up.
Figure 4
Figure 5
Figure 6 - Add the Stitchz OAuth2 Redirect URL (Figure 6) - https://api.stitchz.net/oauth2/authenticated
Figure 7 - Go to Settings > Basic and add the Stitchz.net domain to your App Domains (Figure 7).
Figure 8 - Go to App Review > Permissions and Features (Figure 9). Scroll through the list of available permissions and select Request Advanced Access on the following permissions:
- pages_show_list
- pages_manage_posts
- pages_read_engagement
- Page Public Metadata Access
Figure 9 - Go to App Review > Requests and submit app for review (Figure 10).
Figure 10 - The App approval process can take up to 5 business days to complete. Work closely with the Facebook review team to complete the review as quickly as possible.
- After your app has been approved, copy the new Facebook App ID and App Secret from your Facebook App Dashboard into your Stitchz application. Go to Apps > Settings, then click the shield in the Identity Providers section to add a new provider (Figure 11). In the form that appears, select Facebook and paste your App Id and App Secret, followed by ticking the appropriate scopes/permissions in the Provider Scope section, then click Save.
Figure 11 - From the application Settings page, click the social group name. Next, click the green Add Identity button to add your Facebook Identity (the account responsible for managing the Page). On the modal window click Facebook to begin the process to add your Facebook Identity to Stitchz (Figure 12). Follow the prompts on Facebook's site to complete the request (Figure 13-15).
Figure 12
Figure 13
Figure 14
Figure 15 - After the Identity has been added click the Identity's Pages button to load the list of available pages the Identity has management access to (Figure 16). Click Add Identity to add the Page.
Figure 16 - Setup is complete, you can begin sharing posts on the Facebook Page from Stitchz.
- Add the Facebook Login for Business product to your new app by clicking on Set Up.
- Add the Stitchz OAuth2 Redirect URL (Figure 6) - https://api.stitchz.net/oauth2/authenticated
- Go to App Settings > Basic and add the Stitchz.net domain to your App Domains (Figure 7).
Figure 8 - Under Facebook Login for Business, go to "Configurations".
- Click "Create Configuration"
Figure 8 - Enter a name of your configuration.
Figure 8 - Select the type of access token required for your application. Currently, Stitchz.net supports User Access Tokens (UATs). UATs are associated with your app user's personal account and is a short-lived token for online activities.
Figure 8 - Finally, choose the proper permissions. The following 7 minimum permissions are required:
- business_management
- pages_manage_engagement
- pages_manage_posts
- pages_read_engagement
- pages_read_user_content
- pages_show_list
Figure 8 - Click "Create"
- Copy the "Configuration ID" for use later.
- The final configuration should look similar to the below screenshot.
Figure 8