Social Login (Google & Facebook)

Let your marketplace users sign in with their Google or Facebook account in one click.

Overview

Social login allows your marketplace users to sign in or sign up using their existing Google or Facebook account. It works alongside the existing magic link authentication — users can choose whichever method they prefer.

One-Click Sign-In

Users sign in instantly — no email to type, no link to wait for.

Higher Conversion

Reduce signup friction. Users are more likely to register when they can use an account they already have.

Automatic Account Linking

If a user already signed up with email and later uses Google with the same address, the accounts are linked automatically.

Your Brand

You create your own OAuth app, so the Google/Facebook consent screen shows your marketplace name — not Prometora.

Before You Start

Social login is available on the Professional plan ($99/mo) and above.
You need a Google account and/or a Facebook developer account.
Your marketplace should already be live with a working domain (custom domain or slug-based URL).

Setting Up Google Login

Create a Google Cloud project

Go to the Google Cloud Console and create a new project (or use an existing one). Give it your marketplace name.

Configure the OAuth consent screen

Navigate to APIs & Services → OAuth consent screen.

Choose External user type.
Enter your marketplace name as the app name.
Add your support email and developer contact email.
Add scopes: email, profile, openid.
Add any test users if your app is still in "Testing" mode.

Create OAuth credentials

Go to APIs & Services → Credentials and click Create Credentials → OAuth client ID.

Application type: Web application.
Name: anything you like (e.g. "My Marketplace Login").
Under Authorized redirect URIs, add the redirect URI shown in your Prometora Social Login settings. It looks like:
https://www.prometora.com/api/auth/social/callback
(or your custom domain equivalent)

Copy credentials into Prometora

Google will show you a Client ID and Client Secret. Copy both into your Prometora dashboard under Store Settings → Social Login → Google.

Publish your app (optional but recommended)

While your Google app is in "Testing" mode, only users you manually add as test users can sign in. To allow anyone to sign in, submit your app for verification on the OAuth consent screen page. Google typically approves apps requesting only basic scopes (email, profile) within a few days.

Setting Up Facebook Login

Create a Facebook App

Go to Meta for Developers and click Create App.

Choose "Allow people to log in with their Facebook account" as the use case.
Enter your marketplace name and contact email.

Set up Facebook Login

In your app dashboard, find Facebook Login and click Set Up. Then go to Facebook Login → Settings.

Under Valid OAuth Redirect URIs, add the redirect URI from your Prometora Social Login settings:
https://www.prometora.com/api/auth/social/callback
Save changes.

Copy your App ID and App Secret

Go to App Settings → Basic. Copy the App ID and App Secret into your Prometora dashboard under Store Settings → Social Login → Facebook.

Switch to Live mode

By default your Facebook app is in Development mode, where only app admins and testers can log in. Toggle the switch at the top of the dashboard to Live mode to allow all users. Facebook may ask you to complete a few checks (privacy policy URL, app icon, etc.) before going live.

Enable in Your Dashboard

After adding your credentials, go to Store Settings → Social Login in your Prometora dashboard:

Enable Social Login— master toggle to show social buttons on your sign-in/sign-up pages
Enable Google / Facebook— toggle each provider individually
Save credentials— enter your Client ID/Secret (Google) or App ID/Secret (Facebook) and click Save

That's it! Your sign-in and sign-up pages will now show "Continue with Google" and/or "Continue with Facebook" buttons above the magic link form.

How Account Linking Works

Social login automatically handles existing users:

Scenario	What Happens
User has no account	New buyer account is created automatically
User already signed up with magic link (same email)	Social login links to the existing account — no duplicate
User previously used Google, comes back again	Signed in to the same account instantly

FAQ

Do social users get a buyer or seller account?

Social sign-up creates a buyer account by default. Users can upgrade to seller through the existing "Become a Seller" flow on your marketplace.

Can users still sign in with magic link after enabling social login?

Yes! Social login is shown above the magic link form. Users can choose either method. Both sign into the same account as long as the email matches.

Does it work with custom domains?

Yes. After authentication, users are redirected back to your custom domain automatically. You only need to register one redirect URI (the Prometora one shown in your settings).

Why does the Google consent screen show "Prometora" instead of my brand?

Make sure you set your marketplace name (not "Prometora") as the app name in the Google Cloud OAuth consent screen settings. That name is what Google displays to users.

What if a user's Facebook account doesn't have an email?

An email address is required. If Facebook doesn't provide one (rare, but possible), the user will be redirected back to the sign-in page with an error and can use magic link instead.

Magic Link Authentication Webhooks