---
title: "Add user(s) to channel"
method: POST
path: "/api/v4/channels/{channel_id}/members"
tags: ["channels"]
---

# Add user(s) to channel

`POST /api/v4/channels/{channel_id}/members`

Add a user(s) to a channel by creating a channel member object(s).

## Path parameters

- `channel_id` string, required

## Request body

- object
  - `user_id` string — The ID of user to add into the channel, for backwards compatibility.
  - `user_ids` string[] — The IDs of users to add into the channel, required if 'user_id' doess not exist.
  - `post_root_id` string — The ID of root post where link to add channel member originates

## Response `201`

Channel member creation successful

- 38cb7293ChannelMember
  - `channel_id` string
  - `user_id` string
  - `roles` string
  - `last_viewed_at` integer — The time in milliseconds the channel was last viewed by the user
  - `msg_count` integer
  - `mention_count` integer
  - `notify_props` 38cb7293ChannelNotifyProps
    - `email` string — Set to "true" to enable email notifications, "false" to disable, or "default" to use the global user notification setting.
    - `push` string — Set to "all" to receive push notifications for all activity, "mention" for mentions and direct messages only, "none" to disable, or "default" to use the global user notification setting.
    - `desktop` string — Set to "all" to receive desktop notifications for all activity, "mention" for mentions and direct messages only, "none" to disable, or "default" to use the global user notification setting.
    - `mark_unread` string — Set to "all" to mark the channel unread for any new message, "mention" to mark unread for new mentions only. Defaults to "all".
  - `last_update_at` integer — The time in milliseconds the channel member was last updated

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `401` — No access token provided
- `403` — Do not have appropriate permissions

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)