> For the complete documentation index, see [llms.txt](https://readme.directual.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://readme.directual.com/plugins/using-plugins/user-authentication-plugins-not-web3/facebook-oauth-plugin.md).

# Facebook OAuth Plugin

### Step 1. Create a Facebook app

<https://developers.facebook.com/apps>

### Step 2. Add Facebook login for the app

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2Fz83hVeYneJLHyj8gPbvC%2Ffb-1.png?alt=media\&token=9c696b1c-1ec3-4780-8af6-d7cac9d3fcf6)

### Step 3. Configure app settings

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FuS82rCXDNvsCg1ofksUK%2Ffb-2.png?alt=media\&token=778e4a3f-a0f6-499f-9ef2-009aaf4e47a1)

1. Turn ON Login in with the JS SDK
2. Add your domains (`yourapp.directual.app` or a [custom domain](/web-pages/web-app-settings/custom-domain.md) if you use it)

### Step 4. Copy App ID and App secret

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2F8rzAB7VgD5SO8rReslvJ%2Ffb-3.png?alt=media\&token=874324db-0c47-4f07-9133-ea40d365b7ae)

### Step 5. Set up plugin

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FMurn1YebbuVk248zI8cv%2Ffb-4.png?alt=media\&token=90e7d204-30cd-430d-a5b9-701f9976d7d7)

{% hint style="warning" %}
Note, that if you want your users have a chance to **Sign Up** via Facebook, set the parameter `autoCreateUser` to `true`

Set the parameter `id_as_email` to `true` if you want to have user IDs as their facebook **emails**.
{% endhint %}

### Step 6. Push Facebook app to Live

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2Fx7u0eJrEKS8kCRgwDEQv%2Ffb-5.png?alt=media\&token=bd4d27ef-aebb-4b93-b898-6c13236e499d)

### Step 7. Enjoy

![](https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FSpo3lfmi04fMercri1bY%2Ffb-final.png?alt=media\&token=f9440e50-6775-4b51-8b0d-4d829c070f97)