Admin Api Keys
Admin Campaigns
Admin Claims
Admin Collections
Admin Currencies
Admin Customer Groups
Admin Customers
Admin Draft Orders
Admin Exchanges
Admin Fulfillment Providers
Admin Fulfillment Sets
Admin Fulfillments
Admin Gift Cards
Admin Inventory Items
Admin Invites
Admin Notifications
Admin Order Edits
Admin Orders
Admin Payment Collections
Admin Payments
Admin Plugins
Admin Price Lists
Admin Price Preferences
Admin Product Categories
Admin Product Tags
Admin Product Types
Admin Product Variants
Admin Products
Admin Promotions
Admin Refund Reasons
Admin Regions
Admin Reservations
Admin Return Reasons
Admin Returns
Admin Sales Channels
Admin Shipping Options
Admin Shipping Profiles
Admin Stock Locations
Admin Store Credit Accounts
Admin Stores
Admin Tax Providers
Admin Tax Rates
Admin Tax Regions
Admin Transaction Groups
Admin Uploads
Admin Users
Admin Workflows Executions
Store Auth
- POST
  Set Authentication Session
- DEL
  Delete Authentication Session
- POST
  Refresh Authentication Token
- POST
  Authenticate Customer
- POST
  Validate Authentication Callback
- POST
  Retrieve Registration JWT Token
- POST
  Generate Reset Password Token for Customer
- POST
  Reset a Customer's Password
Admin Auth
Store Carts
Store Collections
Store Currencies
Store Customers
Store Gift Cards
Store Orders
Store Payment Collections
Store Payment Providers
Store Product Categories
Store Product Tags
Store Product Types
Store Products
Store Regions
Store Return Reasons
Store
Store Shipping Options
Store Store Credit Accounts
Admin Algolia
Admin Attributes
Admin Commission
Admin Configuration
Admin Order Sets
Admin Requests
Admin Return Request
Admin Reviews
Admin Sellers
Auth
Store Return Request
Store Reviews
Store Sellers
Store Wishlist
Vendor Attributes
Vendor Campaigns
Vendor Commission
Vendor Configuration
Vendor Customer Groups
Vendor Customers
Vendor Fulfillment Providers
Vendor Fulfillment Sets
Vendor Inventory Items
Vendor Invites
Vendor Current Member
Vendor Members
Vendor Notifications
Vendor Orders
Vendor Payout Account
Vendor Payouts
Vendor Price Lists
Vendor Price Preferences
Vendor Product Categories
Vendor Product Collections
Vendor Product Tags
Vendor Product Types
Vendor Products
Vendor Promotions
Vendor Regions
Vendor Requests
Vendor Reservations
Vendor Return Requests
Vendor Returns
Vendor Sales Channels
Vendor Sellers
Vendor Onboarding
Vendor Reviews
Vendor Shipping Options
Vendor Shipping Profiles
Vendor Statistics
Vendor Stock Locations
Vendor Stores

Store Auth

Validate Authentication Callback

This API route is used by your storefront or frontend application when a third-party provider redirects to it after authentication. It validates the authentication with the third-party provider and, if successful, returns an authentication token. All query parameters received from the third-party provider, such as code, state, and error, must be passed as query parameters to this route. You can decode the JWT token using libraries like react-jwt in the storefront. If the decoded data doesn’t have an actor_id property, then you must register the customer using the Create Customer API route passing the token in the request’s Authorization header.

POST

auth

customer

{auth_provider}

callback

import Medusa from "@medusajs/js-sdk"

let MEDUSA_BACKEND_URL = "http://localhost:9000"

if (process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL) {
  MEDUSA_BACKEND_URL = process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL
}

export const sdk = new Medusa({
  baseUrl: MEDUSA_BACKEND_URL,
  debug: process.env.NODE_ENV === "development",
  publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
})

await sdk.auth.callback(
  "customer",
  "google",
  {
    code: "123",
    state: "456"
  }
)

// all subsequent requests will use the token in the header
const { customer } = await sdk.store.customer.create({
  email: "customer@gmail.com",
  password: "supersecret"
})

{
  "token": "<string>"
}

Path Parameters

auth_provider

string

required

The provider used for authentication.

Example:

"google"

Response

200

application/json

The authentication's details.

Authenticate Customer Retrieve Registration JWT Token

import Medusa from "@medusajs/js-sdk"

let MEDUSA_BACKEND_URL = "http://localhost:9000"

if (process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL) {
  MEDUSA_BACKEND_URL = process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL
}

export const sdk = new Medusa({
  baseUrl: MEDUSA_BACKEND_URL,
  debug: process.env.NODE_ENV === "development",
  publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
})

await sdk.auth.callback(
  "customer",
  "google",
  {
    code: "123",
    state: "456"
  }
)

// all subsequent requests will use the token in the header
const { customer } = await sdk.store.customer.create({
  email: "customer@gmail.com",
  password: "supersecret"
})

{
  "token": "<string>"
}

API Documentation

Path Parameters

Response