Create Browserbase session - Automate.ax

browserbase.createSession creates a configurable cloud browser session and receives connection URLs. Inputs accept literal values or compatible signals. An optional second argument { account } selects a named Browserbase binding.

Example

import { automation, onInvocation } from "automate.ax"
import { browserbase } from "automate.ax/browserbase"

export default automation("Create Browserbase session", () => {
  onInvocation()
  browserbase.createSession({
    browserSettings: { recordSession: true },
    region: "us-west-2",
    timeout: 900,
  })
})

Inputs

Input	Type	Required	Default	Description
`projectId`	`string`	No	API-key project	Project override.
`timeout`	`number`	No	Project default	Session lifetime in seconds, from 60 through 21,600.
`region`	`string`	No	Provider default	`us-west-2`, `us-east-1`, `eu-central-1`, or `ap-southeast-1`.
`keepAlive`	`boolean`	No	`false`	Keep the session alive across client disconnects.
`browserSettings`	`object`	No	Provider defaults	Context, viewport, recording, logging, stealth, CAPTCHA, OS, domain, ad, and TLS settings.
`proxies`	`boolean \| BrowserbaseProxy[]`	No	Provider default	Browserbase, external, or no-proxy rules.
`proxySettings`	`object`	No	None	Trusted certificate IDs.
`userMetadata`	`Record<string, JSON>`	No	None	Searchable session metadata.

Output

Returns the session record plus connectUrl, seleniumRemoteUrl, and signingKey. Creating a session consumes browser capacity and is not replay-safe.