Skip to main content
Docs

Add Facebook as a social connection

You will learn the following:

  • Use Facebook to authenticate users with OAuth

Before you start

Enabling OAuth with Facebook allows your users to sign up and sign in to your Clerk app with their Facebook account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Facebook.
  4. Select Add connection.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Facebook Developer page.

Enable Facebook as a social connection

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Facebook.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Valid OAuth Redirect URI somewhere secure. Keep this modal and page open.

Create a Facebook app

  1. In the top-right of the Facebook Developer page, select My Apps.
  2. In the top-right, select Create App. You'll be redirected to the Create an app process.
    1. In the App details step, fill out the necessary information and select Next.
    2. In the Use Cases step, select Authenticate and request data from users with Facebook Login and then select Next.
    3. In the Business step, select the business portfolio to connect to your app and then select Next.
    4. In the Finalize step, select Go to dashboard. You'll be redirected to the app's Dashboard page.
  3. In the left sidebar, select Use cases.
  4. Next to Authenticate and request data from users with Facebook Login, select Customize. You'll be redirected to the Permissions tab of the Customize use case page.
  5. Next to email, select Add. This permission allows Clerk to read your user's primary email address.
  6. In the left sidebar, under Facebook Login, select Settings.
  7. In the Client OAuth settings section, in the Valid OAuth Redirect URIs field, paste the Valid OAuth Redirect URI value you saved from the Clerk Dashboard.
  8. Select Save changes.
  9. In the left sidebar, select App settings (hover over the icon to view the title or expand the menu), and then select Basic.
  10. Save the App ID and App Secret somewhere secure.

Set the App ID and App Secret in the Clerk Dashboard

  1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the App ID and App Secret values that you saved into the respective fields.
  2. Select Add connection.

Note

If the modal or page is not still open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, you can paste the values into their respective fields.

Test your connection

The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
  • For development – https://your-domain.accounts.dev/sign-in
  • For production – https://accounts.your-domain.com/sign-in
  1. Sign in with your connection's credentials.

Feedback

What did you think of this content?
Edit this page on GitHub

Last updated on