---
title: "Create a browser automation"
method: POST
path: "/v1/browserbase/automations"
tags: ["Browserbase"]
---

# Create a browser automation

`POST /v1/browserbase/automations`

## Request body

- CreateBrowserAutomationDto
  - `taskId` string, required — Task ID this automation belongs to
  - `name` string, required — Automation name
  - `description` string — Automation description
  - `targetUrl` string, required — Target URL to start from
  - `instruction` string, required — Natural language instruction for navigation
  - `evaluationCriteria` string — Optional natural-language criteria used to evaluate the automation result. When set, the run gets a pass/fail verdict.
  - `scheduleFrequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' — Automation schedule cadence

## Response `201`

Automation created

- BrowserAutomationResponseDto
  - `id` string, required
  - `name` string, required
  - `description` string
  - `taskId` string, required
  - `targetUrl` string, required
  - `instruction` string, required
  - `isEnabled` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Changes

- **2026-04-29** `36253e8a5c1b` — 2 warning, 1 info
  - removed the request property `schedule`
  - removed the optional property `schedule` from the response with the `201` status
  - added the new optional request property `scheduleFrequency`
- **2026-04-23** `1f0e2b4ad399` — 1 info
  - added the new optional request property `evaluationCriteria`

[Change history](https://skmtc.dev/trycompai/apis/comp-ai-api/changes/v1/browserbase/automations/post.md)

---

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