Skip to main content
POST
Create subscription

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

dm.read

Read all your Direct Messages.

dm.write

Send and manage your Direct Messages.

tweet.read

View all Posts you can see, including those from protected accounts.

users.read

View any account you can see, including protected accounts.

Path Parameters

webhook_id
string
required

The webhook ID to check subscription against. The unique identifier of this webhook config.

Pattern: ^[0-9]{1,19}$
Example:

"1146654567674912769"

Body

application/json

The body is of type object.

Response

The request has succeeded.

data
object
errors
object[]
Minimum array length: 1

An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).