View as Markdown
Browser Use icon

Browser Use ACTION

Create Browser Session

Create a standalone Browser Use browser session for direct browser control through CDP. Browser sessions are billed by runtime and can run up to 4 hours. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Browser Use account once, then configure and run Create Browser Session from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "browser_use-create-browser-session",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    browser_use: { authProvisionId: "apn_xxxxxxx" },
    profileId: "Profile ID",
    proxyCountryCode: "Proxy Country Code",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Browser Session inputs
Property Type Description
profileId Profile ID string
Select a Browser Use profile or provide a profile ID.
Optional Dynamic
proxyCountryCode Proxy Country Code string
Lowercase proxy country code for browser traffic. Examples: us, de, jp. Enter none to disable Browser Use's proxy.
Optional
timeout Timeout integer
Session timeout in minutes. Browser Use supports 1 to 240 minutes.
Optional
browserScreenWidth Browser Screen Width integer
Custom browser screen width in pixels. Supported range: 320 to 6144.
Optional
browserScreenHeight Browser Screen Height integer
Custom browser screen height in pixels. Supported range: 320 to 3456.
Optional
allowResizing Allow Resizing boolean
Whether to allow browser resizing during the session. Browser Use does not recommend this because it can reduce stealthiness.
Optional
customProxy Custom Proxy object
Optional custom proxy object. Example: {"host":"proxy.example.com","port":8080,"username":"user","password":"pass"}. Custom proxies require an active subscription.
Optional
enableRecording Enable Recording boolean
If true, records the browser session.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
browser_use-create-browser-session
Version
0.0.2
App
Browser Use
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes