Skip to main content
POST
Create DM conversation

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes3
tweet.read
View all posts you can see, including those from protected accounts.
dm.write
Send and manage your Direct Messages.
users.read
View any account you can see, including protected accounts.

Body

application/json
conversation_type
enum<string>
required

The conversation type to create. Supports Group only.

Available options:
Group
message
object
required

The initial Direct Message to send to the conversation.

participant_ids
string[]
required

Participants for the conversation.

Required array length: 2 - 49 elements
Pattern: ^[0-9]{1,19}$

Response

The request has succeeded.

data
object
errors
object[]