Creating Facebook Applications

In this section, we'll go through the steps for creating and configuring a Facebook application through the Facebook developers portal.


Step 1: Create your Social Network Application

Login with Facebook, enter: developers.facebook.com and register a Facebook developer account by clicking Get started in the top right corner.

Then, go to the My Apps dropdown and click "Add a new App".


A pop-up will appear with fields for your to enter your desired Display Name, Contact Email and Category. Fill in the fields with the correct information, and then click "Create App ID".



Once your Facebook application is created, please send us the App ID and App SECRET, Privacy Policy URL, and App Icon (1024 x 1024px; transparent background) at support@xeerpa.com. This information can be found under Settings > Basic. See below:




Step 2: Configuring the callback URL

The callback URL is the URL where you should redirect the user when they complete the social login process. You are required to include the callback URL in the configuration settings of your application so that Facebook can confirm you own this URL and that it is secure.

To configure your callback URL, click on +Add Product in the left-hand menu and then click "Get Started" in the Facebook Login tab. 



Step 3: Decide which user permissions you will ask for in your app

By default, Facebook allows you to request the following basic user permissions (no extra steps required):

  • public_profile
  • email


However, in order to obtain additional valuable information from your users such us their Likes, Posts or Locations, we also recommend to request these advanced Facebook permissions:

  • user_birthday
  • user_friends
  • user_gender
  • user_location
  • user_posts
  • user_tagged_places
  • user_likes


In order to request these advanced user permissions, your application will have to be approved by Facebook through a review process, where Facebook will check that all data privacy and usage requirements are met according to their policies. Without approval, your Facebook application will only be allowed to request basic user permissions. To submit your Facebook application for review, navegate to the App Review section in the left-hand menu and click "Start a Submission". 



On the next screen that appears, you'll see a list of all the advanced user permissions  that can be requested, for which you are requesting approval from Facebook. Select the user permissions you would like to request in order to access specific social datapoints about each user that logs in via your Facebook login option:


Step 4: Getting Facebook approval to request advanced user permissions

As part of the review process, Facebook will be checking that your application makes use of the social data requested to enchance the user's interactive experience on your website, application, mobile application or Wi-Fi hotspot. 

To get your applications approved by Facebook, you'll need to:

  1. Implement the Xeerpa Connect Summary Widget (see below).
  2. Send submission to Facebook.
Need help with the Facebook's approval process?
Contact us at support@xeerpa.com to help you get your applications approved by Facebook.

Once you've selected the desired user permissions, Facebook's review process can take anywhere between 3-5 days. 


Xeerpa Connect Summary Widget

In order to make your website or app comply with Facebook's regulations and obtain its permissions' approval, Xeerpa has developed a set of widgets that can be easily implemented in your website and app and that will provide the necessary functionality to meet Facebook's requirements. Setup is easy: just insert a snippet of code (HTML, CSS and Javascript) provided by Xeerpa in an empty div anywhere within your website or app. If you'd like to utilize these widgets, please get in touch with us at support@xeerpa.com.

How they work

  1. User signs in with Facebook into your website or app.
  2. User accepts your request for user permissions.
  3. Xeerpa analyses the user's profile and returns the widget's HTML code based on her/his data.
  4. The HTML code can be rendered anywhere within your website or app, typically the "My Profile" page.
Please note: These widgets render content in your website that must be accessible to the user. Keep this in mind when designing your website or app. Get in touch to see examples of these widgets and how other clients are using them.

How to use them

To use the Xeerpa Connect Summary Widget, they must be invoked in the call to Xeerpa. Depending on the connection method you're utilizing, have a look at either Xeerpa Connect Backend Auth or Xeerpa Connect Discovery to learn more about implementing these widgets.