All Collections
Advanced
Social Logins
How to enable Facebook Login
How to enable Facebook Login

This article explains the basic steps to create a Facebook app and connect it to your marketplace to allow Facebook Login use.

Luis Rodriguez avatar
Written by Luis Rodriguez
Updated over a week ago

IMPORTANT! In order to enable Facebook Login you need to have a valid and verified Business registered with Facebook. Without one, you will not be able to use this feature. You can read more about how to verify your business in Facebook's own documentation:

  1. How to verify your business directly from your developer App

  2. How to verify your business in general explaining the verification steps

Both documents are helpful if you are planning to verify your business and use Facebook Login. Please contact Facebook Support if you have issues.

The process of creating an Facebook app to use Facebook Login is relatively straightforward. However, there are two caveats:

  • The different pages that they use to try to improve the onboarding experience can sometimes make the whole experience more confusing.

  • You need to have a verified business account registered with Facebook in order to be able to use your app publicly.

However, if you follow this guide step by step, you should be able

Note: Facebook's interface is subject to change without previous notice. We try to update our documentation as soon as we notice changes in the third-party UI. If you encounter any inconsistencies with this step-by-step guide, please contact Sharetribe's Support team, and we will be happy to assist.

Once you have a verified business with Facebook/Meta, to enable Facebook Login in your marketplace, you need to do two things:

  1. Create a Facebook development app

  2. Connect that app to your marketplace through Console.

Create a Facebook development app

  1. Go to https://developers.facebook.com/.

  2. Log in. If you do not have a Facebook account you will need to sign up.

    1. If you don't have a Facebook account, you will need to also create and verify your business with Facebook. Refer to the note at the start of this article

  3. Click "Create an App" and follow the creation steps

    1. Choose the option "Authenticate and request data from users with Facebook Login".

    2. Click "Next".

    3. Select "No, I'm not building a game".

    4. Fill out the name of the app, the contact email and select the business manager account (you would have created this when verifying your business with Facebook).

  4. Ignore the Dashboard that you land on and go straight to the "App settings" menu on the bottom left, click it.

  5. Choose "Basic". You will need to add a lot of information in this page.

    1. In "App domains", add all the domains from which you want the Facebook login to work, i.e. all your marketplace domains. Add the domains without any subdomain, for example www, so if your marketplace runs in https://www.example.com, add example.com.

    2. Add the Privacy Policy URL of your marketplace.

    3. Add the Terms of Service URL.

    4. Add an App icon.

    5. Select a Category.

    6. Add the User data deletion URL (either your Privacy Policy page or a Page that you create specific for this).

    7. Scroll all the way to the bottom and click "+ Add platform".

    8. Select "Website" and click Next.

    9. In "Site URL", add your complete marketplace's URL with https and possibly www or the subdomain, e.g. https://www.example.com. Note that the Site URL needs to have the same domain you added to "App domains", or one of them if you added many.

  6. Save changes

  7. Go to "Use cases" in the left menu

    1. If you have an older version of Facebook developers app UI, you might not see Use cases and should find Facebook Login settings instead.

  8. In "Authentication and account creation", click "Customize".

  9. In "Permissions", toward the bottom, click "Add" for "email"

  10. In "Settings", click "Go to settings".

  11. Under "Client OAuth settings" check that the following settings are correct:

    • Client OAuth login: Yes

    • Web OAuth login: Yes

    • Enforce HTTPS: Yes

    • Force Web OAuth Reauthentication: No

    • Embedded Browser OAuth Login: No

    • Use Strict Mode for Redirect URIs: Yes

    • Login from devices: No

    • Login with the JavaScript SDK: No

  12. In the "Valid OAuth redirect URIs" field add your marketplace address, followed by /api/auth/facebook/callback, for example: https://www.example.com/api/auth/facebook/callback.

  13. Save changes

  14. Your Facebook app is now ready for development.

    1. Note that while the app is in development mode, only you and other app developers can use it to log in.

  15. Whenever you are ready to go live, you need to go back to the Dashboard page of your Facebook app, and click on the "Publish" option in the left menu.

Some screenshots that might help

Create App

Basic settings

Use cases menu

Connect the Facebook Login app to your marketplace

  1. Go to Console > Advanced > Social logins & SSO

  2. Click "+ Add a new client..."

  3. As the client name, type "Facebook Login".

  4. As an identity provider choose "Facebook"

  5. Add the App ID and the App secret as a Client ID and Client secret, respectively.

    1. You can find this in the Basic section of your "App settings"

  6. Click "Add client"

  7. That's it!

Test it out

You should make sure that things work by testing your signup and login process with Facebook. If you haven't verified your business with Facebook, you will still be able to test Facebook login as long as you use the same email as the one on Facebook.

Related Articles
How to connect a custom domain to your marketplace
1. Create a new user account
How adding payout details works with Stripe
How to enable Google login
What are social logins and Single Sign-on (SSO)
Did this answer your question?