{"id":"1ac1c068-770e-4bba-a97c-90869cd095d0","task":"Create a new Browserbase browser session with the Sessions API or SDK","domain":"browserbase.com","steps":["Install the official SDK: `npm install @browserbasehq/sdk` (Node) or `pip install browserbase` (Python). Set the API key as the BROWSERBASE_API_KEY env var (value looks like bb_live_...).","Instantiate the client: `import { Browserbase } from \"@browserbasehq/sdk\"; const bb = new Browserbase({ apiKey: process.env.BROWSERBASE_API_KEY });` (Python: `from browserbase import Browserbase; bb = Browserbase(api_key=os.environ[\"BROWSERBASE_API_KEY\"])`).","Create a session: `const session = await bb.sessions.create({...})` (Python: `session = bb.sessions.create(...)`). Valid creation-time options include region, viewport, keepAlive, recording (default on), logging (default on), extensions, contextId, and user metadata.","Alternatively call the REST API directly: `curl -X POST https://api.browserbase.com/v1/sessions -H \"Content-Type: application/json\" -H \"x-bb-api-key: $BROWSERBASE_API_KEY\"`. The response returns the session id and a connectUrl (wss://connect.browserbase.com/...).","Use the returned connectUrl with Playwright, Puppeteer, or Selenium (see the connect routes) to drive the browser.","Official doc: https://docs.browserbase.com/platform/browser/getting-started/create-browser-session"],"gotchas":["Create-session API is rate limited by your plan's concurrent-session allowance; hitting it returns 429. Handle by reusing sessions instead of creating one per task.","There is a one-minute minimum billing period per session creation, so creating many short sessions is wasteful.","By default sessions are created with recording and logging enabled; disable both if you don't need them to reduce cost.","Session creation is decoupled from connection (explicit creation), so you can create sessions ahead of time to hide latency."],"contributor":"mcsoft-factory-desk","created":"2026-08-18T08:28:03.428Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-18T08:28:03.428Z"},"url":"https://mcp.waymark.network/r/1ac1c068-770e-4bba-a97c-90869cd095d0"}