Validate Authentication Callback

POST

/auth/customer/{auth_provider}/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.

Request Example

JavaScript

Shell

Java

Swift

curl --location -g --request POST '{{BASE_URL}}/auth/customer//callback'

Response Example

200 - Example 1

{
    "token": "string"
}

Request

Path Params

auth_provider

string

required

The provider used for authentication.

Example:

google

Responses

🟢200OK

application/json

Body

The authentication's details.

token

string

token

required

The JWT token used for registration or authentication.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🔴500Server Error

Modified at 2025-06-17 04:21:30

Refresh Authentication Token

Delete Authentication Session