---
title: "POST /users/@me/channels"
method: POST
path: "/users/@me/channels"
---

# POST /users/@me/channels

`POST /users/@me/channels`

## Request body

- CreatePrivateChannelRequest
  - `recipient_id` string, snowflake
  - `access_tokens` string[], nullable
  - `nicks` object, nullable

## Response `200`

200 response for create_dm

- union
  - PrivateChannelResponse
    - `id` string, snowflake, required
    - `type` union, required
      - 1 — A direct message between users
      - 3 — A direct message between multiple users
      - 0 — A text channel within a server
      - 2 — A voice channel within a server
      - 4 — An organizational category that contains up to 50 channels
      - 5 — A channel that users can follow and crosspost into their own server (formerly news channels)
      - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel
      - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set
      - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission
      - 13 — A voice channel for hosting events with an audience
      - 14 — The channel in a hub containing the listed servers
      - 15 — Channel that can only contain threads
    - `last_message_id` string, snowflake
    - `flags` integer, required
    - `last_pin_timestamp` string, date-time, nullable
    - `recipients` UserResponse[], required
      - `id` string, snowflake, required
      - `username` string, required
      - `avatar` string, nullable, required
      - `discriminator` string, required
      - `public_flags` integer, required
      - `flags` integer, required
      - `bot` boolean
      - `system` boolean
      - `banner` string, nullable
      - `accent_color` integer, nullable
      - `global_name` string, nullable, required
      - `avatar_decoration_data` UserAvatarDecorationResponse
        - `asset` string, required
        - `sku_id` string, snowflake, required
      - `collectibles` UserCollectiblesResponse
        - `nameplate` UserNameplateResponse, required — unresolved $ref
      - `primary_guild` UserPrimaryGuildResponse, required
        - `identity_guild_id` string, snowflake, required
        - `identity_enabled` boolean, nullable, required
        - `tag` string, nullable, required
        - `badge` string, nullable, required
  - PrivateGroupChannelResponse
    - `id` string, snowflake, required
    - `type` union, required
      - 1 — A direct message between users
      - 3 — A direct message between multiple users
      - 0 — A text channel within a server
      - 2 — A voice channel within a server
      - 4 — An organizational category that contains up to 50 channels
      - 5 — A channel that users can follow and crosspost into their own server (formerly news channels)
      - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel
      - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set
      - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission
      - 13 — A voice channel for hosting events with an audience
      - 14 — The channel in a hub containing the listed servers
      - 15 — Channel that can only contain threads
    - `last_message_id` string, snowflake
    - `flags` integer, required
    - `last_pin_timestamp` string, date-time, nullable
    - `recipients` UserResponse[], required
      - `id` string, snowflake, required
      - `username` string, required
      - `avatar` string, nullable, required
      - `discriminator` string, required
      - `public_flags` integer, required
      - `flags` integer, required
      - `bot` boolean
      - `system` boolean
      - `banner` string, nullable
      - `accent_color` integer, nullable
      - `global_name` string, nullable, required
      - `avatar_decoration_data` UserAvatarDecorationResponse
        - `asset` string, required
        - `sku_id` string, snowflake, required
      - `collectibles` UserCollectiblesResponse
        - `nameplate` UserNameplateResponse, required — unresolved $ref
      - `primary_guild` UserPrimaryGuildResponse, required
        - `identity_guild_id` string, snowflake, required
        - `identity_enabled` boolean, nullable, required
        - `tag` string, nullable, required
        - `badge` string, nullable, required
    - `name` string, nullable, required
    - `icon` string, nullable, required
    - `owner_id` string, snowflake, required
    - `managed` boolean
    - `application_id` string, snowflake

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

- **2026-02-04** `e200830e509a` — 22 info
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/avatar` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - …18 more

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/users/@me/channels/post.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc.dev/discord/apis/discord-http-api-preview/revisions/83811125e038?raw)