Skip to main content
DELETE
Delete Twitter webhook endpoint & stop events
Free - does not consume credits
These snippets shape a deactivation receipt. Store the webhook ID with its inventory and delivery-log endpoints instead of printing the raw delete response.

What delete does

DELETE /webhooks/{id} soft-deactivates the endpoint by setting isActive to false. The webhook record stays available in List Webhooks, and previous delivery rows stay available in List Deliveries. The response is only { "success": true }; it does not return the URL, event types, or signing secret. To receive events again, call Update Webhook with isActive: true, then run Test Webhook before routing production monitor events to the receiver.

Path parameters

string
required
The webhook ID to deactivate.

Headers

string
required
Your API key. This endpoint also accepts session cookie authentication.

Response

200 OK

boolean
Always true on successful deactivation.
The webhook is deactivated immediately. Pending deliveries that are already in-flight may still be attempted, but no new deliveries will be queued.

401 Unauthenticated

Missing or invalid API key / session cookie.

400 Invalid ID

The provided webhook ID is not a valid format.

404 Not found

No webhook exists with this ID, or it belongs to a different account.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.

Deactivation handoff

Use this endpoint when a receiver should stop getting future monitor events but you still need the webhook record and delivery history for audit or rollback.

Soft deactivate

The endpoint sets isActive to false and returns { "success": true }. It does not return the webhook configuration.

Future deliveries

Inactive webhooks do not receive new monitor deliveries or scheduled retries. In-flight delivery attempts may still finish.

Audit trail

Use List Webhooks to confirm webhooks[].isActive: false, then use List Deliveries for prior delivery status, attempts, errors, and timestamps.

Delivery audit

Delivery rows for inactive endpoints can show pending, failed, or exhausted attempts. Store streamEventId, status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt.

Event join

Use delivery streamEventId as the {id} for Get Event. Store monitorId, monitorType, type, occurredAt, and data with the deactivation record.

Receiver cleanup

Remove queue, CRM, alerting, or warehouse routing only after the endpoint is inactive and no more production events are expected.

Reactivate

To reuse the same webhook, call Update Webhook with isActive: true, then run Test Webhook.

Signing secret

Delete returns no secret. Keep the original Create Webhook secret for audit records or future reactivation.
This endpoint supports dual authentication: API key (x-api-key header) or session cookie from the dashboard.Related. List Webhooks · Update Webhook · Test Webhook · List Deliveries · Get Event · Create Webhook