Sign in
latestOpenAPI 3.1.02026-07-26180242448.0 KB

4a1ef8777baf

Stream Webhooks

Create webhook

Create a new webhook endpoint for a stream monitor. Webhooks receive HMAC-SHA256 signed POST requests when new tweets are detected.

post/v1/twitter/stream/webhooks

Request body

monitor_idstring required

The ID of the stream monitor to attach this webhook to.

urlstring required

HTTPS URL to receive webhook deliveries. Must use HTTPS.

secretstring nullable

Secret used to sign webhook payloads with HMAC-SHA256.

Example request

{
  "url": "https://example.com/webhooks/twitter"
}

Response

Webhook created successfully.

idstring required

Unique webhook identifier.

monitor_idstring required

ID of the associated stream monitor.

urlstring required

HTTPS URL of the webhook endpoint.

secretstring nullable

Webhook secret for HMAC-SHA256 signing. Only returned once on creation.

created_atstring date-time required

Timestamp when the webhook was created.