Skip to main content
POST
Create Chat Group 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.
users.read
View any account you can see, including protected accounts.
dm.write
Send and manage your Direct Messages.

Body

application/json
conversation_id
string
required

Client-generated conversation ID.

conversation_key_version
string
required

Version of the conversation encryption key.

conversation_participant_keys
object[]
required

Encrypted conversation keys for each participant.

group_members
string[]
required

User IDs of group members to include in the conversation.

action_signatures
object[]

Cryptographic signatures for the action.

base64_encoded_key_rotation
string

Base64-encoded key rotation payload.

group_admins
string[]

User IDs of group admins. Defaults to the creator if omitted.

group_avatar_url
string

URL of the avatar image for the group conversation.

group_description
string

Description for the group conversation.

group_name
string

Display name for the group conversation.

ttl_msec
string

Message time-to-live in milliseconds. Messages expire after this duration.

Response

The request has succeeded.

data
object
errors
object[]