POST /channels/create

Default value: "application/x-www-form-urlencoded"

The description to use for the new channel being created, in text/markdown format.

Clients should use the max_stream_description_length returned by the POST /register endpoint to determine the maximum channel description length.

A group-setting value defining the set of users who have permission to remove subscribers from this channel.

Organization administrators can unsubscribe others from a channel as though they were in this group without being explicitly listed here.

Note that a user must have metadata access to a channel and permission to administer the channel in order to modify this setting.

Changes: Prior to Zulip 10.0 (feature level 349), channel administrators could not unsubscribe other users if they were not an organization administrator or part of can_remove_subscribers_group. Realm administrators were not allowed to unsubscribe other users from a private channel if they were not subscribed to that channel.

Prior to Zulip 10.0 (feature level 320), this value was always the integer ID of a system group.

Before Zulip 8.0 (feature level 197), the can_remove_subscribers_group setting was named can_remove_subscribers_group_id.

New in Zulip 6.0 (feature level 142).

A group-setting value defining the set of users who have permission to delete the messages that they have sent in the channel.

Note that a user must have content access to a channel in order to delete their own message in the channel.

Users with permission to delete any message in the channel and users present in the organization-level can_delete_own_message_group setting can always delete their own messages in the channel if they have content access to that channel.

Changes: New in Zulip 11.0 (feature level 407). Prior to this change, only the users in the organization-level can_delete_any_message_group and can_delete_own_message_group settings were able delete their own messages in the organization.

A group-setting value defining the set of users who have permission to resolve topics in the channel.

Users who have similar realm-level permissions can resolve topics in a channel regardless of the value of this setting.

Changes: New in Zulip 11.0 (feature level 402).

This parameter determines whether the newly created channel will be added as a default channel for new users joining the organization.

Default value: false

A group-setting value defining the set of users who have permission to create a new topic in this channel.

Note that using this permission requires also having permission to send messages in the channel.

Note that this must be the role:everyone system group for private channels with protected history.

Changes: New in Zulip 12.0 (feature level 441). Previously, if you could send messages in a channel, you could create topics in the channel.

Number of days that messages sent to this channel will be stored before being automatically deleted by the message retention policy. Two special string format values are supported:

• "realm_default": Return to the organization-level setting.
• "unlimited": Retain messages forever.

Changes: Prior to Zulip 5.0 (feature level 91), retaining messages forever was encoded using "forever" instead of "unlimited".

New in Zulip 3.0 (feature level 17).

This parameter and the ones that follow are used to request an initial configuration of the new channel.

This parameter determines whether the newly created channel will be a private channel.

Default value: false

Whether named topics and the empty topic (i.e., "general chat" topic) are enabled in this channel.

• "inherit": Messages can be sent to named topics in this channel, and the organization-level realm_topics_policy is used for whether messages can be sent to the empty topic in this channel.
• "allow_empty_topic": Messages can be sent to both named topics and the empty topic in this channel.
• "disable_empty_topic": Messages can be sent to named topics in this channel, but the empty topic is disabled.
• "empty_topic_only": Messages can be sent to the empty topic in this channel, but named topics are disabled. See "general chat" channels.

The "empty_topic_only" policy can only be set if all existing messages in the channel are already in the empty topic.

When creating a new channel, if the topics_policy is not specified, the "inherit" option will be set.

Changes: In Zulip 11.0 (feature level 404), the "empty_topic_only" option was added.

New in Zulip 11.0 (feature level 392).

Valid values:

• "empty_topic_only"
• "inherit"
• "allow_empty_topic"
• "disable_empty_topic"

A list of user IDs of the users to be subscribed to the new channel.

This parameter adds the newly created channel to the specified channel folder.

Changes: New in Zulip 11.0 (feature level 389).

The name of the new channel.

Clients should use the max_stream_name_length returned by the POST /register endpoint to determine the maximum channel name length.

This parameter determines whether the newly created channel will be a web-public channel.

Note that creating web-public channels requires the WEB_PUBLIC_STREAMS_ENABLED server setting to be enabled on the Zulip server in question, the organization to have enabled the enable_spectator_access realm setting, and the current user to have permission under the organization's can_create_web_public_channel_group realm setting.

Default value: false

A group-setting value defining the set of users who have permission to administer this channel.

Organization administrators can administer every channel as though they were in this group without being explicitly listed here.

Note that a user must have metadata access to a channel and permission to administer the channel in order to modify this setting.

Changes: Prior to Zulip 10.0 (feature level 349) a user needed to have content access to a channel in order to modify it. The exception to this rule was that organization administrators can edit channel names and descriptions without having full access to the channel.

New in Zulip 10.0 (feature level 325). Prior to this change, the permission to administer channels was limited to realm administrators.

A group-setting value defining the set of users who have permission to post in this channel.

Note that a user must have metadata access to a channel and permission to administer the channel in order to modify this setting.

Note that using this permission to send a message to a new topic requires also having permission to create new topics in the channel.

Changes: New in Zulip 10.0 (feature level 333). Previously stream_post_policy field used to control the permission to post in the channel.

This determines whether notification bot will send an announcement about the new channel's creation.

Default value: false

A group-setting value defining the set of users who have permission to subscribe themselves to this channel.

Everyone, excluding guests, can subscribe to any public channel irrespective of this setting.

Users in this group can subscribe to a private channel as well.

Note that a user must have content access to a channel and permission to administer the channel in order to modify this setting.

Changes: New in Zulip 10.0 (feature level 357).

A group-setting value defining the set of users who have permission to delete any message in the channel.

Note that a user must have content access to a channel in order to delete any message in the channel.

Users present in the organization-level can_delete_any_message_group setting can always delete any message in the channel if they have content access to that channel.

Changes: New in Zulip 11.0 (feature level 407). Prior to this change, only the users in can_delete_any_message_group were able delete any message in the organization.

Whether the channel's message history should be available to newly subscribed members, or users can only access messages they actually received while subscribed to the channel.

Corresponds to the shared history option for private channels.

A group-setting value defining the set of users who have permission to move messages out of this channel.

Note that a user must have content access to a channel in order to move messages out of the channel.

Channel administrators and users present in the organization-level can_move_messages_between_channels_group setting can always move messages out of the channel if they have content access to the channel.

Changes: New in Zulip 11.0 (feature level 396). Prior to this change, only the users in can_move_messages_between_channels_group were able move messages between channels.

A group-setting value defining the set of users who have permission to move messages within this channel.

Note that a user must have content access to a channel in order to move messages within the channel.

Channel administrators and users present in the organization-level can_move_messages_between_topics_group setting can always move messages within the channel if they have content access to the channel.

Changes: New in Zulip 11.0 (feature level 396). Prior to this change, only the users in can_move_messages_between_topics_group were able move messages between topics of a channel.

A group-setting value defining the set of users who have permission to add subscribers to this channel.

Users who can administer the channel or have similar realm-level permissions can add subscribers to a public channel regardless of the value of this setting.

Users in this group need not be subscribed to a private channel to add subscribers to it.

Note that a user must have content access to a channel and permission to administer the channel in order to modify this setting.

Changes: New in Zulip 10.0 (feature level 342). Previously, there was no channel-level setting for this permission.