---
title: "Create Browser Session"
method: POST
path: "/v1/browser/session"
---

# Create Browser Session

`POST /v1/browser/session`

Create a new hosted browser session.

## Request body

- object
  - `type` 'hosted' — Use hosted Driver infrastructure for the session.
  - `country` string — Start a session in a specific country using its 2-letter ISO code. Optional.
  - `nodeId` string — Create the hosted session on a specific previously used hosted node. Optional. Overrides country.
  - `duration` integer — The duration of the browser session in seconds. Optional. Default is 3600 seconds (1 hour). Cannot be greater than 3600 seconds (1 hour). Cannot be less than 60 seconds (1 minute).
  - `windowSize` string — The window size for the browser session in the format WIDTHxHEIGHT (e.g., 1920x1080). Optional.
  - `proxyUrl` string — SOCKS5 proxy URL for the session. Optional. Requires hosted sessions and cannot be used with nodeId.
  - `profile` object — The browser profile to use for the session. Optional.
    - `name` string, required — The name of the browser profile.
    - `persist` boolean — Whether to save browser state for reuse after the session stops.
  - `fast` boolean — Attempt faster startup when the request is eligible. Optional.
  - `captchaSolver` boolean — Enable the built-in CAPTCHA solver for the session. Optional. Default is false.
  - `extensionIds` string[] — Chrome extension IDs to load into the browser session. Optional. Requires extension access for your account.

## Response `200`

Successfully created a browser session.

- object
  - `sessionId` string, required — The ID of the created browser session.
  - `status` 'starting' | 'active' | 'completed' | 'error', required — The status of the session.
  - `servedBy` string, required — The node ID that is serving this session.
  - `createdAt` string, required — The ISO 8601 timestamp when the session was created.
  - `stoppedAt` string, nullable, required — The ISO 8601 timestamp when the session was stopped, or null if it is still active.
  - `cdpUrl` string, uri, nullable, required — The URL to access the Chrome DevTools Protocol for this session, or null if not available.
  - `note` string, nullable, required — An optional note attached to the session, or null if not set.

## Other responses

- `401` — Missing or invalid token.
- `500` — Failed to create a browser session.

## Changes

- **2026-06-10** `fe4827822116` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/browsercash/apis/driver-api/changes/v1/browser/session/post.md)

---

[API](https://skmtc.dev/browsercash/apis/driver-api.md) · [All operations](https://skmtc.dev/browsercash/apis/driver-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/browsercash/driver-api/revisions/fe4827822116/schema)