Create a hosted session

POST

/v3/api/business/reseller/hosted_sessions

Creates an opaque, short-lived session URL for a client, to be opened inside a webview in your app.

The client should already have (or be about to receive) an issued pass — see Passes.

Idempotent — supply Idempotency-Key to safely retry.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

*/*

Session created

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/hosted_sessions' \
--header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "bardge9370"
}'

Response Example

200 - Success

{
    "object": "hosted_session",
    "url": "https://bardge-webview.vercel.app/xO9IT8bnVasaN2P2NBbLrIz0i05p4O48",
    "message": "SUCCESS"
}

Modified at 2026-08-14 09:13:15

Introduction

RegisterWebhookV3Request