---
title: "Create a new browser participant"
method: POST
path: "/openvidu-browser/streamManager"
tags: ["Stream Manager"]
---

# Create a new browser participant

`POST /openvidu-browser/streamManager`

## Request body

- CreateUserBrowser
  - `openviduUrl` string, uri, required
  - `token` string
  - `properties` UserJoinProperties, required
    - `userId` string, required
    - `sessionName` string, required
    - `role` 'PUBLISHER' | 'SUBSCRIBER', required
    - `audio` boolean, required
    - `video` boolean, required
    - `resolution` '640x480' | '1280x720' | '1920x1080', required
    - `frameRate` integer, required
    - `browser` 'chrome' | 'firefox' | 'custom-emulated', required
    - `recording` boolean
    - `showVideoElements` boolean
    - `headless` boolean
    - `recordingMetadata` string
    - `mediaRecorders` boolean
    - `disableAutoSubscribeForPublishers` boolean — Debug-only. For PUBLISHER participants, disables auto-subscription so the publisher doesn't also subscribe to other participants' tracks. For custom-emulated publishers it omits --auto-subscribe from the underlying `lk room join` command; for real-browser publishers it sets autoSubscribe=false in the LiveKit room connect options. Has no effect on SUBSCRIBER participants.

## Response `200`

Stream manager created successfully

- CreateUserBrowserResponse
  - `connectionId` string
  - `streams` integer
  - `participants` integer
  - `workerCpuUsage` number
  - `sessionId` string
  - `userId` string

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

## Changes

- **2026-07-22** `08801569ae54` — 1 breaking, 1 info
  - removed the enum value `emulated` of the request property `properties/browser`
  - added the new `custom-emulated` enum value to the request property `properties/browser`
- **2026-07-17** `e19f0f62e7ae` — 1 warning
  - removed the request property `properties/disableAutoSubscribeForPublishers`
- **2026-07-03** `2a129c0ccdb5` — 1 info
  - added the new optional request property `properties/disableAutoSubscribeForPublishers`

[Change history](https://skmtc.dev/openvidu/apis/browser-emulator-api/changes/openvidu-browser/streamManager/post.md)

---

[API](https://skmtc.dev/openvidu/apis/browser-emulator-api.md) · [All operations](https://skmtc.dev/openvidu/apis/browser-emulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openvidu/browser-emulator-api/revisions/18732332a4cb/schema)