Skip to main content

Create Session

POST 
/api/v1/sessions

Create a verification session.

Returns a single URL that can be shared with the user to complete verification. The URL contains an embedded token - no separate access token handling needed.

Example:

POST /api/v1/sessions
{
  "external_user_id": "user-123",
  "email": "user@example.com",
  "redirect_url": "https://yourapp.com/callback"
}

Response:
{
  "session_id": "...",
  "url": "https://app.bytrustgate.com/v/xK9mN2pQ7rS",
  "applicant_id": "...",
  "expires_at": "..."
}

Then simply redirect or share the URL with your user.

Request​

Responses​

Successful Response