v1

latestOpenAPI 3.0.0Twitter Developer Agreement and Policy2026-07-1480235216.3 KB
Direct Messages

Send a new message to a user

Creates a new message for a DM Conversation with a participant user by ID

post/2/dm_conversations/with/{participant_id}/messages

Path parameters

participant_idstring required

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:2244994945

The ID of the recipient user that will receive the DM.

Request body

OR

Example request

{
  "attachments": [
    {
      "media_id": "1146654567674912769"
    }
  ]
}

Response

The request has succeeded.

Example response

{
  "data": {
    "dm_conversation_id": "123123123-456456456",
    "dm_event_id": "1146654567674912769"
  }
}