createConversation abstract method

Future<TwitterResponse<MessageData, void>> createConversation({ required String participantId, required MessageParam message, })

Creates a one-to-one Direct Message and adds it to the one-to-one conversation.

This method either creates a new one-to-one conversation or retrieves the current conversation and adds the Direct Message to it.

Parameters

• participantId: The User ID of the account this one-to-one Direct Message is to be sent to.

• message: The object that contains the text and attachments parameters.

Endpoint Url

• https://api.twitter.com/2/dm_conversations/with/:participant_id/messages

Authentication Methods

• OAuth 2.0 Authorization Code with PKCE
• OAuth 1.0a

Required Scopes

• tweet.read
• users.read
• dm.read
• dm.write

Rate Limits

• 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.

Reference

• https://developer.twitter.com/en/docs/twitter-api/direct-messages/manage/api-reference/post-dm_conversations-with-participant_id-messages

Implementation

Future<TwitterResponse<MessageData, void>> createConversation({
  required String participantId,
  required MessageParam message,
});