Skip to main content
POST
Add members to a 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
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

id
string
required
Pattern: ^([0-9]{1,19}|[0-9]{1,19}-[0-9]{1,19}|g[0-9]{1,19})$

Body

application/json
user_ids
string[]
required

List of user IDs to add to the group conversation.

action_signatures
object[]

Cryptographic signatures for the action.

conversation_key_version
string

Version of the new rotated conversation key.

conversation_participant_keys
object[]

Encrypted conversation keys for each participant.

encrypted_avatar_url
string

Re-encrypted group avatar URL with new conversation key.

encrypted_title
string

Re-encrypted group title with new conversation key.

Response

The request has succeeded.

data
object
errors
object[]