Monitoring

Register Webhook

Register a delivery target for monitors to send matches to. Requires a recognised monitoring entitlement, which every account has: a free account can register a webhook for its free all-of-Reddit watch. Returns the webhook with its signing secret SHOWN ONCE, so store it immediately, it is never returned again by List Webhooks. Cost: Free per call.

post/api/reddit/monitor/webhook/create

Request

  • Base URL: https://api.redditapis.com
  • URL: https://api.redditapis.com/api/reddit/monitor/webhook/create
  • Auth: HTTP bearer

Request body

urlstring required

HTTPS URL to deliver matches to. Must be publicly reachable, no embedded credentials, no loopback/private/link-local address.

kind'webhook' | 'slack' | 'discord' | 'email'

Payload shape to send. Prefer omitting it: for a hooks.slack.com or discord.com/api/webhooks URL the kind is inferred from the host and the response reports it in kind_inferred_from. slack/discord format as native incoming-webhook messages; webhook sends redditapis' generic signed JSON envelope and is the fallback for an unrecognised host. Sending webhook for a Slack or Discord URL does not force the generic envelope (that combination can never deliver); the host wins and kind_corrected_from says so. Sending one specific kind for a different platform's host is refused with webhook_kind_mismatch (400).

Response

Successful response.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.