---
title: "Create Profile"
method: POST
path: "/profiles"
tags: ["Profiles"]
---

# Create Profile

`POST /profiles`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/profiles`
- Auth: API key in header `X-Browser-Use-API-Key`

Profiles allow you to preserve the state of the browser between tasks.

They are most commonly used to allow users to preserve the log-in state in the agent between tasks.
You'd normally create one profile per user and then use it for all their tasks.

You can set a `user_id` when creating a profile to associate it with a user in your system.
This allows you to later search for the profile using the GET /profiles endpoint with a query parameter.

## Request body

- ProfileCreateRequest: Request model for creating a new profile.
  - `name` string, nullable: Optional name for the profile
  - `userId` string, nullable: Your internal user identifier for this profile. Use this to associate a profile with a user in your system.

## Response `201`

Successful Response

- ProfileView: View model for representing a profile. A profile lets you preserve the login state between sessions. We recommend that you create a separate profile for each user of your app. You can assign a user_id to each profile to easily identify which user the profile belongs to.
  - `id` string, uuid, required: Unique identifier for the profile
  - `userId` string, nullable: Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
  - `name` string, nullable: Optional name for the profile
  - `lastUsedAt` string, date-time, nullable: Timestamp when the profile was last used
  - `createdAt` string, date-time, required: Timestamp when the profile was created
  - `updatedAt` string, date-time, required: Timestamp when the profile was last updated
  - `cookieDomains` string[], nullable: List of domain URLs that have cookies stored for this profile

## Other responses

- `402`: Profile limit reached; delete unused profiles to create new ones
- `422`: Request validation failed

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)