Manage Direct Messages

The Manage Direct Messages endpoints let you send and delete Direct Messages on behalf of. Reference for the X API v2 standard tier covering manage.

The Manage Direct Messages endpoints let you send and delete Direct Messages on behalf of authenticated users.

Overview

Send message

Send a DM to another user

Delete message

Delete a DM for yourself

Create conversation

Start a new conversation

Group messages

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

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

{
  "data": {
    "dm_conversation_id": "1234567890-0987654321",
    "dm_event_id": "1122334455667788990"
  }
}

---

Message types

You can send text messages and attach media:

{
  "text": "Check out this photo!",
  "attachments": [{
    "media_id": "1234567890123456789"
  }]
}

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• User Access Tokens via OAuth 2.0 PKCE

Quickstart

Send your first DM

Integration guide

Key concepts and best practices

DM lookup

Retrieve DM events

API Reference

Full endpoint documentation