createGroupConversation abstract method

Future<TwitterResponse<MessageData, void>> createGroupConversation({ required List<String> participantIds, required MessageParam message, })

Creates a new group conversation and adds a Direct Message to it on behalf of an authenticated user.

Parameters

• participantIds: An array of User IDs that the conversation is created with. Conversations can have up to 50 participants.

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

Endpoint Url

• https://api.twitter.com/2/dm_conversations

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

Implementation

Future<TwitterResponse<MessageData, void>> createGroupConversation({
  required List<String> participantIds,
  required MessageParam message,
});