v1

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

Direct Messages

Create a new DM Conversation

Creates a new DM Conversation.

post/2/dm_conversations

Request body

conversation_type'Group' required

The conversation type that is being created.

participant_idsUserId[] required

Participants for the DM Conversation.

Example request

{
  "message": {
    "attachments": [
      {
        "media_id": "1146654567674912769"
      }
    ]
  },
  "participant_ids": [
    "2244994945"
  ]
}

Response

The request has succeeded.

Example response

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