---
title: "Create a browser profile"
method: POST
path: "/v1/browser_profiles"
tags: ["Browser Profiles"]
---

# Create a browser profile

`POST /v1/browser_profiles`

Create a browser profile from a persistent browser session or workflow run.

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Request body

- CreateBrowserProfileRequest
  - `name` string, required — Name for the browser profile
  - `description` string, nullable — Optional profile description
  - `browser_session_id` string, nullable — Persistent browser session to convert into a profile
  - `workflow_run_id` string, nullable — Workflow run whose persisted session should be captured

## Response `200`

Successfully created browser profile

- BrowserProfile
  - `browser_profile_id` string, required
  - `organization_id` string, required
  - `name` string, required
  - `description` string, nullable
  - `source_browser_type` string, nullable
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `deleted_at` string, date-time, nullable

## Other responses

- `400` — Invalid request - missing source or source not found
- `409` — Browser profile name already exists
- `422` — Validation Error

## Changes

- **2026-05-28** `172f5de044f2` — 1 breaking
  - the `name` request property's minLength was increased from `0` to `1`
- **2026-05-09** `9a8565aaedbf` — 1 info
  - added the optional property `source_browser_type` to the response with the `200` status
- **2026-05-09** `f97d3f2efafe` — 1 warning
  - removed the optional property `source_browser_type` from the response with the `200` status
- **2026-05-09** `9a8565aaedbf` — 1 info
  - added the optional property `source_browser_type` to the response with the `200` status

[Change history](https://skmtc.dev/skyvern-ai/apis/skyvern-api/changes/v1/browser_profiles/post.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api/revisions/fdb894aa6708/schema)