Skip to main content
POST
Configure Slack Webhook

Overview

Configure a Slack incoming webhook to receive notifications when jobs fail. You can choose to receive all failure notifications, errors only (technical failures), or warnings only (content issues like private/unavailable videos). The webhook URL is stored securely and encrypted at rest.

Header Parameters

string
required
Your API key for authentication

Request

string
required
Slack incoming webhook URL. Must start with https://hooks.slack.com/services/.
string
default:"all"
Controls which failure types trigger a Slack notification:
  • all — Both errors and warnings (default)
  • errors_only — Only technical failures (rate limits, bot detection, connection errors)
  • warnings_only — Only content issues (private video, members-only, geo-blocked, unavailable)

Examples

Success Response

Error Responses

If you already have a Slack webhook configured, calling this endpoint again will replace the existing webhook and notify level.

Notification Format

When a job fails, Tornado sends a Slack message with a colored attachment:
  • Red (:x:) for technical errors (rate limits, connection issues, bot detection)
  • Orange (:warning:) for content warnings (private video, members-only, geo-blocked, unavailable)
The message includes the Job ID, a sanitized error category (no internal infrastructure details are exposed), and the source URL.

Notify Level Reference

What counts as an error vs warning?

Only failed jobs trigger Slack notifications. Completed, pending, and processing jobs do not send any notification to Slack.