---
title: "Add Room Leader (Realtime)"
slug: "add-room-leader-realtime"
updated: 2026-05-14T21:49:19Z
published: 2026-05-14T21:49:19Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Room Leader (Realtime)

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Deprecated.svg)

Set a user as room leader.

| Method | Requires Auth | Permission |
| --- | --- | --- |
| `addRoomLeader` | Yes | `set-leader` |

## Payload parameters

| Argument | Example | Required | Description |
| --- | --- | --- | --- |
| `roomId` | `64a1f373376181965ab77f54` | Required | The room ID. |
| `userId` | `5fRTXMt7DMJbpPJfh` | Required | The user ID to be set as room leader. |

## Example call

```json
{
    "msg": "method",
    "method": "addRoomLeader",
    "id": "2",
    "params": [
        "WDuJLFkjwk6L7LdFC",
        "5fRTXMt7DMJbpPJfh"
    ]
}
```

## **Example response**

### **Success**

```json
{
    "msg": "result",
    "id": "2",
    "result": true
}
```

### Errors

- **User not in the room**: This occurs when the `userId` doesn't belong to any user in the room.
- **Invalid User**: This occurs when the `userId` doesn't belong to any user in the workspace.
- **User is already a Leader**: This occurs when user is already a leader in that room.
- **No Permission:**This occurs when the authenticated user does not have the `set-leader` permission.

- [User not in the room](/apidocs/add-room-leader-realtime#tabs-1)
- [Invalid User](/apidocs/add-room-leader-realtime#tabs-2)
- [User is already a Leader](/apidocs/add-room-leader-realtime#tabs-3)
- [No Permission](/apidocs/add-room-leader-realtime#tabs-4)

```json
{
    "msg": "result",
    "id": "2",
    "error": {
        "isClientSafe": true,
        "error": "error-user-not-in-room",
        "reason": "User is not in this room",
        "details": {
            "method": "addRoomLeader"
        },
        "message": "User is not in this room [error-user-not-in-room]",
        "errorType": "Meteor.Error"
    }
}
```

```json
{
    "msg": "result",
    "id": "2",
    "error": {
        "isClientSafe": true,
        "error": "error-invalid-user",
        "reason": "Invalid user",
        "details": {
            "method": "addRoomLeader"
        },
        "message": "Invalid user [error-invalid-user]",
        "errorType": "Meteor.Error"
    }
}
```

```json
{
    "msg": "result",
    "id": "2",
    "error": {
        "isClientSafe": true,
        "error": "error-user-already-leader",
        "reason": "User is already a leader",
        "details": {
            "method": "addRoomLeader"
        },
        "message": "User is already a leader [error-user-already-leader]",
        "errorType": "Meteor.Error"
    }
}
```

```json
{
    "msg": "result",
    "id": "2",
    "error": {
        "isClientSafe": true,
        "error": "error-not-allowed",
        "reason": "Not allowed",
        "details": {
            "method": "addRoomLeader"
        },
        "message": "Not allowed [error-not-allowed]",
        "errorType": "Meteor.Error"
    }
}
```