Facebook authentication

Facebook authentication lets your users sign in with the Facebook account they already use. Once connected, you can offer “Continue with Facebook” in your WeWeb app.

Setup in the Meta dashboard

1. Go to the Meta for Developers.
2. Create an app (or open an existing one).
3. Add the Facebook Login product (if needed).
4. In the Facebook Login settings, add a redirect URL (sometimes called a “Valid OAuth Redirect URI”).
   • Use the WeWeb callback URL: the address of your app followed by /api/auth/callback/facebook. The table below lists the URLs to add.
5. Copy your app credentials (usually an App ID and App Secret).

Add one callback URL for each place where users sign in:

Where users sign in	Callback URL to add in Meta
Editor	https://<your-project>-editor.weweb.io/api/auth/callback/facebook
Staging app	https://<your-project>-staging.weweb.io/api/auth/callback/facebook
Published app	https://<your-project>-production.weweb.io/api/auth/callback/facebook
Custom domain	https://your-domain.com/api/auth/callback/facebook

Replace <your-project> with your project's WeWeb subdomain. You can see it in your browser's address bar when the editor is open, for example bright-harbor in https://bright-harbor-editor.weweb.io.

CALLBACK URL VS SUCCESS PAGE

Meta always sends users back to the callback URL, never to a page of your app. WeWeb then completes sign in and takes users to the Success Page, Error Page, or New User Page you choose in the Sign in with social provider action. Do not add the URL of these pages in Meta.

Connect Facebook in WeWeb

1. In the WeWeb editor, open the Data & API tab, then open the Authentication subtab and go to SSO Providers.
2. Select Facebook and turn on the Enable toggle.
3. Paste your values into the fields shown in WeWeb (for example Client ID / App ID and Client Secret / App Secret).
4. Click Save.

Test sign in

1. Add a “Continue with Facebook” button in Interface.
2. Create a workflow on click and add Sign in with social provider.
3. Set:
   • Provider: facebook
   • Success Page, Error Page, and (optional) New User Page
4. Preview and complete the Facebook sign-in flow.

Common pitfalls

Redirect URL mismatch

If Meta shows a redirect URL error, make sure the “Valid OAuth Redirect URI” exactly matches the WeWeb callback URL ending with /api/auth/callback/facebook (no trailing slash), not the Success Page URL used in WeWeb.

App in development mode

If only some users can sign in, your app may be in development mode. Add test users in Meta or switch to live mode when you’re ready.

Reference

Setting in WeWeb	Description	Where to find it in Meta
Client ID / App ID	Identifies your Meta app.	App dashboard settings.
Client Secret / App Secret	Used to complete the sign-in flow securely.	App dashboard settings.

FAQs

Which redirect URL should I add in Meta?

Add the address of your app followed by /api/auth/callback/facebook, for example https://your-domain.com/api/auth/callback/facebook. Add one for each place where users sign in (editor, staging app, published app, custom domain). The URL of your Success Page is not the redirect URL.