Create Browser Profile | Browser Use Cloud Docs

Create a new browser profile with custom settings for ad blocking, proxy usage, and viewport dimensions. Pay as you go users can only have one profile. Subscription users can create multiple profiles.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

profile_namestringRequired>=1 character<=100 characters

descriptionstringOptional>=0 characters<=1000 charactersDefaults to

persistbooleanOptionalDefaults to false

ad_blockerbooleanOptionalDefaults to true

proxybooleanOptionalDefaults to false

proxy_country_codeenumOptional

store_cachebooleanOptionalDefaults to false

browser_viewport_widthintegerOptional>=100<=3840Defaults to 1280

browser_viewport_heightintegerOptional>=100<=2160Defaults to 960

is_mobilebooleanOptionalDefaults to false

Response

Successful Response

profile_idstringformat: "uuid"

profile_namestring

descriptionstring

persistboolean

ad_blockerboolean

proxyboolean

proxy_country_codeenum

browser_viewport_widthinteger

browser_viewport_heightinteger

store_cacheboolean

is_mobileboolean

1	curl -X POST https://api.browser-use.com/api/v1/browser-profiles \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"profile_name": "string"
6	}'

1	{
2	"profile_id": "string",
3	"profile_name": "string",
4	"description": "string",
5	"persist": true,
6	"ad_blocker": true,
7	"proxy": true,
8	"proxy_country_code": "us",
9	"browser_viewport_width": 1,
10	"browser_viewport_height": 1,
11	"store_cache": true,
12	"is_mobile": true
13	}

Headers

Request

Response

Errors