Create a session with X402 payment
Purchase one browser session at 0.10 USDC per hour, paid upfront for timeoutMinutes (5–60, default 30). No Hyperbrowser account or API key is required. A valid unpaid request returns 402 with payment requirements. Retry with a signed PAYMENT-SIGNATURE authorization. Payment is settled before connection credentials and a managementToken are returned. One authorization can create only one session. Invalid options are rejected before payment verification. See /integrations/x402/sessions for connection examples and lifetime behavior.
timeoutMinutes (5–60, default 30), without a Hyperbrowser API key. See the
X402 session guide for signing the payment request, connecting
to the returned browser, and session lifetime behavior.Headers
Base64-encoded payment authorization generated by an X402 client from the advertised PAYMENT-REQUIRED requirements. Omit on the initial request to obtain a quote.
Body
Optional preferences for a browser session priced at 0.10 USDC per hour, paid upfront for timeoutMinutes. Unknown fields are rejected before payment verification. Web recording is disabled. Other regular session creation options are not supported.
Browser screen dimensions. An omitted dimension uses its default.
Make the live-view link read-only. CDP, WebDriver, and the computer action endpoint still allow browser control.
Maximum session lifetime in minutes, from 5 through 60. Defaults to 30. Determines the session duration and upfront price at 0.10 USDC per hour. Connection token lifetimes and expiresAt follow this value.
5 <= x <= 60Response
Browser created and payment settled. Use the returned connection details to control it without further X402 payments.
Connection credentials and a management token for the purchased browser. Save this response; get does not reissue connection credentials. These tokens cannot authenticate regular account APIs.
Purchased session ID.
CDP WebSocket URL for Playwright, Puppeteer, or another CDP client. Includes its authentication token.
Selenium/WebDriver endpoint. Send token in the x-hyperbrowser-token header.
Authenticated live-view URL. Interaction is disabled when viewOnlyLiveView is true.
Endpoint for mouse, keyboard, and screenshot actions. Includes its authentication token.
Credential scoped to this browser session. Use it for WebDriver authentication, not the regular get/list/stop/update/extend session APIs.
Returned session expiry timestamp based on timeoutMinutes. The browser can stop earlier if closed or disconnected.
Bearer token for GET /x402/session/{id} and PUT /x402/session/{id}/stop only. Valid for 24 hours from purchase, including after browser expiry. Does not authenticate browser connections or regular account APIs.