POST /2/dm_conversations/:dm_conversation_id/messages
Creates a Direct Message on behalf of an authenticated user, and adds it to the specified conversation.
Endpoint URL
https://api.twitter.com/2/dm_conversations/:dm_conversation_id/messages
Authentication and rate limits
Authentication methods supported by this endpoint |
OAuth 2.0 Authorization Code with PKCE (Recommended) OAuth 1.0a is also available for this endpoint. |
---|---|
Rate limit | User rate limit (User context): 200 requests per 15-minute window per each authenticated user User rate limit (User context): 1000 requests per 24-hour window per each authenticated user App rate limit: 15000 requests per 24-hour window shared among the app |
OAuth 2.0 scopes required by this endpoint
|
Learn more about OAuth 2.0 Authorization Code with PKCE |
Path parameters
Name | Type | Description |
---|---|---|
dm_conversation_id Required |
string | The dm_conversation_id of the conversation to add the Direct Message to. Supports both 1-1 and group conversations. |
JSON body parameters
Name | Type | Description |
---|---|---|
attachments Optional |
array | A single Media ID being attached to the Direct Message. This field is required if text is not present. For this launch, only 1 attachment is supported.Example: {"text": "Sending a DM with media!", "attachments": [{"media_id": "1455952740635586573"}] |
text Optional |
string | Text of the Direct Message being created. This field is required if attachments is not present. Text messages support up to 10,000 characters.Example: {"text": "Hello just you conversation participants!""} |
Example commands
Example responses
Response fields
Name | Type | Description |
---|---|---|
dm_conversation_id | string | Contains the id of the Direct Message conversation the Direct Message was added to. |
dm_event_id | string | Contains the id of the event created by this request. |