# X Direct Messages API

**Canonical:** https://apis.io/apis/x/x-direct-messages-api/  
**Provider:** X — https://apis.io/providers/x/  
**Base URL:** https://api.x.com  
**Documentation:** https://docs.x.com/x-api/direct-messages/introduction

X Direct Messages API is one of 23 APIs that [X](https://apis.io/providers/x/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Direct Messages. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Endpoints related to retrieving, managing Direct Messages — 9 operation(s) in the X-published contract.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/2/dm_conversations` | Create DM conversation |
| GET | `/2/dm_conversations/media/{dm_id}/{media_id}/{resource_id}` | Download DM Media |
| GET | `/2/dm_conversations/with/{participant_id}/dm_events` | Get Direct Messages Events by Participant ID |
| POST | `/2/dm_conversations/with/{participant_id}/messages` | Create DM message by participant ID |
| POST | `/2/dm_conversations/{dm_conversation_id}/messages` | Create Direct Messages by Conversation ID |
| GET | `/2/dm_conversations/{id}/dm_events` | Get Direct Messages Events by Conversation ID |
| GET | `/2/dm_events` | Get Direct Messages Events |
| DELETE | `/2/dm_events/{event_id}` | Delete DM event |
| GET | `/2/dm_events/{event_id}` | Get Direct Messages Events by ID |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-direct-messages-api-openapi.yml
- **Documentation** — https://docs.x.com/x-api/direct-messages/introduction

## Other X APIs (12)

- [X Account Activity API](https://apis.io/apis/x/x-account-activity-api/)
- [X Account API](https://apis.io/apis/x/x-account-api/)
- [X Activity API](https://apis.io/apis/x/x-activity-api/)
- [X Articles API](https://apis.io/apis/x/x-articles-api/)
- [X Bots API](https://apis.io/apis/x/x-bots-api/)
- [X Broadcasts API](https://apis.io/apis/x/x-broadcasts-api/)
- [X Chat API](https://apis.io/apis/x/x-chat-api/)
- [X Communities API](https://apis.io/apis/x/x-communities-api/)
- [X Community Notes API](https://apis.io/apis/x/x-community-notes-api/)
- [X Compliance API](https://apis.io/apis/x/x-compliance-api/)
- [X Connections API](https://apis.io/apis/x/x-connections-api/)
- [X General API](https://apis.io/apis/x/x-general-api/)

## Tags

Direct Messages

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/x/x-direct-messages-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/x/.