ZEzerohash
User Token

Initialize session

Create a new session and receive a JWT for authenticated API requests.

post/api/v1/sessions

Request

  • Base URL
    https://api.sandbox.connect.xyz
  • URL
    https://api.sandbox.connect.xyz/api/v1/sessions
  • Auth
    HTTP bearer

Headers

x-connect-client-idstring required

Client ID that must match the organization ID in the JWT token

Signaturestring required

Request signature for validation (required for most organizations)

timestampstring required

Timestamp used for signature validation

Request body

request_idstring

Optional request ID. If not provided, a UUID will be generated automatically

scopes'user:deposit:send' | 'user:recovery:send' | 'user:withdrawal:request'

List of scopes for the session

Example request

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "account": {
    "reference_id": "07NVS8"
  },
  "session": {
    "metadata": {
      "organization_metadata": "test-01-10-001",
      "user_agent": "Mozilla/5.0...",
      "ip_address": "192.168.1.1"
    },
    "withdrawal_details": {
      "asset": "BTC",
      "network": "bitcoin",
      "amount": "0.001",
      "account_label": "Main Account"
    },
    "deposit_details": {
      "account_label": "Main Account"
    }
  }
}

Response

Session created successfully

jwtstring required

JWT token for the created session

expires_ininteger required

Token expiration time in seconds

Example response

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

Changes

No recorded changes to this operation across all 1 revision of this API.