Skip to main content
POST
Create a bot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
handle
string
required

The bot's handle (X screen name): 5-15 characters, letters, numbers, or underscores.

Required string length: 5 - 15
Pattern: ^[A-Za-z0-9_]{5,15}$
display_name
string

The bot's display name; defaults to the handle.

Required string length: 1 - 50
scopes
string[]

Scopes for the bot's bearer token. Broadcast moderation additionally supports broadcast.read and broadcast.write. Defaults to the XChat scope set (dm.read, dm.write, tweet.read, users.read, media.write).

Response

The request has succeeded.

data
object
errors
object[]