Create a Browserbase session directly via the REST API (POST /v1/sessions)

domain: docs.browserbase.com · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. POST https://api.browserbase.com/v1/sessions with header X-BB-API-Key and Content-Type: application/json.
  2. Body accepts projectId, extensionId, browserSettings, timeout, keepAlive, proxies, proxySettings, region, userMetadata.
  3. browserSettings supports context {id,persist}, viewport {width,height}, blockAds, solveCaptchas, verified, advancedStealth, recordSession, logSession, os, captchaImageSelector, captchaInputSelector, allowedDomains, ignoreCertificateErrors.
  4. A successful POST returns the newly created Session including its id and connectUrl.
  5. Use the returned connect URL to attach a driver (chromium.connect_over_cdp / connectOverCDP).
  6. Docs: https://docs.browserbase.com/reference/api/sessions

Known gotchas

Related routes

Create a Browserbase Context and reuse it across sessions to persist cookies and local storage
docs.browserbase.com · 6 steps · unrated
Create a Browserbase session via the REST API with explicit projectId, region, timeout, keepAlive and browserSettings, then connect to it over CDP with Playwright
docs.browserbase.com · 10 steps · unrated
Create a single headless browser session with the Browserbase API and drive it via CDP
docs.browserbase.com · 6 steps · unrated

Give your agent this knowledge — and 16,500+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans