View as Markdown
Browser Use icon

Browser Use ACTION

Create Session

Create an agent session, dispatch a task, or dispatch a follow-up task to an existing idle session. 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 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-session",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    browser_use: { authProvisionId: "apn_xxxxxxx" },
    task: "Task",
    model: "Model",
  },
})

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 Session inputs
Property Type Description
task Task string
Natural-language instruction for the agent. Example: Go to example.com and summarize the pricing page. Required when dispatching to an existing session.
Optional
model Model string
Browser Use agent model. claude-sonnet-4.6 is balanced, claude-opus-4.6 is most capable, and gemini-3-flash is fast and lower cost.
Optional
sessionId Session ID string
Select a Browser Use agent session or provide a session ID.
Optional Dynamic
keepAlive Keep Alive boolean
If true, the session stays idle after the task completes so it can accept follow-up tasks.
Optional
maxCostUsd Max Cost USD string
Maximum total session cost in USD. Example: 1.50.
Optional
profileId Profile ID string
Select a Browser Use profile or provide a profile ID.
Optional Dynamic
workspaceId Workspace ID string
Select a Browser Use workspace or provide a workspace 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
outputSchema Output Schema object
Optional JSON Schema for structured output. Example: {"type":"object","properties":{"price":{"type":"number"},"title":{"type":"string"}}}.
Optional
enableScheduledTasks Enable Scheduled Tasks boolean
If true, the agent can create scheduled tasks tied to your project.
Optional
sensitiveData Sensitive Data object
Optional key-value pairs available to the agent through secure placeholders. Example: {"password":"secret-value"}. Keys are visible to the model; values are hidden but may appear in screenshots if typed into unmasked fields.
Optional
enableRecording Enable Recording boolean
If true, Browser Use records the browser session and returns recording URLs after completion.
Optional
skills Enable Skills boolean
If true, enables built-in Browser Use agent skills such as file management.
Optional
agentmail Enable AgentMail boolean
If true, provisions a temporary email inbox for the session.
Optional
cacheScript Cache Script string
Controls deterministic script caching. Auto enables caching when the task contains @{{value}} placeholders and a workspace is attached.
Optional
useOwnKey Use Own Key boolean
If true, uses your configured LLM provider key instead of Browser Use managed keys.
Optional
autoHeal Auto Heal boolean
When script caching is active, validates cached script output and reruns the full agent if the result looks incorrect.
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-session
Version
0.0.2
App
Browser Use
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes