users_create_dm
users_create_dm
Section titled “users_create_dm”Category: users
Open (or fetch) a DM channel between the bot and a user (POST /users/@me/channels).
When to use
Section titled “When to use”- Send a private message to a user — Discord requires a DM channel id first.
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
recipient_id | string | yes | User to DM |
Returns
Section titled “Returns”\{channel_id, type, recipient_ids\}. Use channel_id with messages_send to deliver the DM.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Discord channel ID (snowflake) |
type | integer | yes | |
recipient_ids | array | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |