Validate Authentication Callback

POST

/auth/user/{auth_provider}/callback

This API route is used by your dashboard 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 frontend. If the decoded data doesn't have an actor_id property, then you must create a user, typically using the Accept Invite route passing the token in the request's Authorization header.

Request Example

JavaScript

Shell

Java

Swift

curl --location -g --request POST '{{BASE_URL}}/auth/user//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:10:32

Refresh Authentication Token

Generate Reset Password Token for Admin User