Skip to main content
POST
Create DM message by participant ID

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
users.read
View any account you can see, including protected accounts.
tweet.read
View all posts you can see, including those from protected accounts.
dm.write
Send and manage your Direct Messages.

Path Parameters

participant_id
string
required
Pattern: ^[0-9]{1,19}$

Body

application/json

At least one of text, attachments is required.

text
string
required

Text of the Direct Message.

Minimum string length: 1
attachments
object[]

Attachments to include with the message.

Response

The request has succeeded.

data
object
errors
object[]