> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-b4f5bfb1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage Direct Messages
> Use the X API v2 Manage Direct Messages endpoints to create conversations, send new DMs, and delete DM events on behalf of authenticated users on X.
export const Button = ({href, children}) => {
return ;
};
The Manage Direct Messages endpoints let you send and delete Direct Messages on behalf of authenticated users.
## Overview
Send a DM to another user
Delete a DM for yourself
Start a new conversation
Send to group conversations
***
## Endpoints
| Method | Endpoint | Description |
| :----- | :-------------------------------------------------- | :------------------------------ |
| POST | `/2/dm_conversations` | Create a new conversation |
| POST | `/2/dm_conversations/with/:participant_id/messages` | Send to one-to-one conversation |
| POST | `/2/dm_conversations/:dm_conversation_id/messages` | Send to existing conversation |
| DELETE | `/2/dm_events/:id` | Delete a DM event |
***
## Example: Send a message
```bash theme={null}
curl -X POST "https://api.x.com/2/dm_conversations/with/1234567890/messages" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Hello! How are you?"}'
```
## Example response
```json theme={null}
{
"data": {
"dm_conversation_id": "1234567890-0987654321",
"dm_event_id": "1122334455667788990"
}
}
```
***
## Message types
You can send text messages and attach media:
```json theme={null}
{
"text": "Check out this photo!",
"attachments": [{
"media_id": "1234567890123456789"
}]
}
```
***
## Getting started
**Prerequisites**
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* User Access Tokens via [OAuth 2.0 PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2)
Send your first DM
Key concepts and best practices
Retrieve DM events
Full endpoint documentation