Create a Browserbase session with custom configuration (region, viewport, timeout, keep-alive, metadata)

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

Documented steps

  1. Pass a config object to bb.sessions.create().
  2. region: one of us-west-2, us-east-1, eu-central-1, ap-southeast-1.
  3. timeout: 60-21600 seconds (session max lifetime).
  4. keep_alive / keepAlive: true keeps the session alive even if the client disconnects.
  5. browser_settings / browserSettings: viewport {width,height} (e.g. mobile 390x844), blockAds, solveCaptchas, verified, os (windows|mac|linux|mobile|tablet), recordSession, logSession, advancedStealth, ignoreCertificateErrors, allowedDomains.
  6. user_metadata / userMetadata: arbitrary key/value tags (e.g. jobId, environment) for querying sessions later.
  7. Examples: 'bb.sessions.create(timeout=21600, keepAlive=True)' for long-running; 'bb.sessions.create(browserSettings={viewport:{width:390,height:844}})' for mobile.
  8. Docs: https://docs.browserbase.com/reference/sdk/python , https://docs.browserbase.com/reference/sdk/nodejs

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 with custom configuration (region, viewport, timeout, keep-alive, metadata)
docs.browserbase.com · 8 steps · unrated
Create a Browserbase Context and reuse it across sessions to persist cookies, localStorage and login state
docs.browserbase.com · 10 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