Customer

Social login

Verify a provider token the app/web already obtained (Google Identity Services or a native SDK — no redirect), then sign the customer in, creating and linking the account on first sight. Returns a Bearer token for subsequent calls. Providers: google, facebook, linkedin.

post/customers/social-login

Request

Headers

X-STOREFRONT-KEYstring required

Storefront API Key for authentication. Required for all shop/storefront API requests.

X-Localestring
Example:en

Locale code for localized data (e.g. "en", "fr", "ar"). Defaults to channel's default locale.

X-Channelstring
Example:default

Channel code (e.g. "default"). Defaults to the current channel.

X-Currencystring
Example:USD

Currency code (e.g. "USD", "EUR", "INR"). Defaults to channel's base currency.

Request body

provider'google' | 'facebook' | 'linkedin' required
idTokenstring

Google ID token (google only).

accessTokenstring

OAuth access token (facebook / linkedin, or google).

deviceTokenstring

Optional FCM token to register push in the same call.

Example request

{
  "provider": "google",
  "idToken": "eyJhbGciOi…"
}

Response

Signed in. Store token as the Bearer token. isNewCustomer marks a first-time sign-up.

Changes

No recorded changes to this operation across all 13 revisions of this API.