Create Session | Browser Use Cloud Docs

Create a new session with a new task.

X-Browser-Use-API-Keystring

API Key authentication via header

This endpoint expects an object.

profileIdstring or nullOptionalformat: "uuid"

The ID of the profile to use for the session

proxyCountryCodeenum or nullOptional

Country code for proxy location.

startUrlstring or nullOptional

URL to navigate to when the session starts.

Successful Response

idstringformat: "uuid"

Unique identifier for the session

statusenum

Current status of the session (active/stopped)

Allowed values:

startedAtdatetime

Timestamp when the session was created and started

liveUrlstring or null

URL where the browser can be viewed live in real-time

finishedAtdatetime or null

Timestamp when the session was stopped (None if still active)

1	import requests
2
3	url = "https://api.browser-use.com/api/v2/sessions"
4
5	payload = {}
6	headers = {
7	"X-Browser-Use-API-Key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())