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; defaults to the standard bot scope set (dm.read, dm.write, tweet.read, users.read, media.write).

Response

The request has succeeded.

data
object
errors
object[]