---
title: "Create a room user"
method: POST
path: "/room/{id}/user"
tags: ["room"]
deprecated: true
---

# Create a room user

`POST /room/{id}/user`

> **Deprecated.**

Call this endpoint to add a user to a room, specifying a display name at a minimum.
The response will contain a joining URL for Livepeer's default meeting app.
Alternatively the joining token can be used with a custom app.

## Path parameters

- `id` string, required

## Request body

- RoomUserPayload
  - `name` string, required — Display name
  - `canPublish` boolean — Whether a user is allowed to publish audio/video tracks
  - `canPublishData` boolean — Whether a user is allowed to publish data messages to the room
  - `metadata` string — User defined payload to store for the participant

## Response `201`

Success

- RoomUserResponse
  - `id` string — The ID of the user
  - `joinUrl` string — Joining URL - use this for Livepeer's default meeting app (see the multiparticipant streaming guide for more info).
  - `token` string — Joining JWT - this can be used if you have a custom meeting app (see the multiparticipant streaming guide for more info).

## Other responses

- `default` — Error

## Changes

- **2024-05-17** `fc477586b24c` — 1 breaking
  - the response property `errors` became optional for the status `default`
- **2024-04-23** `d0909f9b9414` — 3 info
  - api operation id `createRoomUser` was added
  - api tag `room` added
  - endpoint deprecated

[Change history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/room/:id/user/post.md)

---

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