Users

Create private channel

Creates a new private channel (direct message) between the current user and one or more recipients. Group DM creation requires CAPTCHA verification. Returns the newly created channel object.

post/users/@me/channels

Request body

recipient_idstring snowflake

recipientsSnowflakeType[]

Array of user IDs for creating a group DM (max 49)

Response

Success

idstring required

The unique identifier (snowflake) for this channel

guild_idstring snowflake

namestring

The name of the channel

topicstring nullable

The topic of the channel

urlstring uri nullable

The URL associated with the channel

iconstring nullable

The icon hash of the channel (for group DMs)

owner_idstring snowflake

typeinteger required

The type of the channel

positioninteger

parent_idstring snowflake

bitrateinteger

user_limitinteger

voice_connection_limitinteger

rtc_regionstring nullable

The voice region ID for the voice channel

last_message_idstring snowflake

last_pin_timestampstring date-time nullable

The ISO 8601 timestamp of when the last pinned message was pinned

nsfwboolean

Whether the channel is marked as NSFW (effective value, walking channel → category → guild)

nsfw_overrideboolean nullable

Per-channel adult-content override; null means inherit from parent category and then guild. Categories use this same field as their own override.

content_warning_level0 | 1

The content warning level for a guild, category, or channel

content_warning_textstring nullable

Custom channel content warning text (max 200 characters); null inherits from parent or guild

rate_limit_per_userinteger

nicksobject

Custom nicknames for users in this channel (for group DMs)

Changes

No recorded changes to this endpoint across all 1 revision of this API.