Webhooks

Event type

SnitchFeed sends webhooks only when a new match is stored for your organization. Each request uses payload version 1.0 with:

"event": {
  "id": "<unique delivery id>",
  "type": "match.created",
  "timestamp": "<ISO datetime>",
  "version": "1.0"
}

Other product events are not emitted over webhooks.

HTTP delivery

• Method: POST
• Body: JSON (Content-Type: application/json)
• Success: Respond with any 2xx status so we record the delivery as successful.
• Timeout: Requests time out after 10 seconds.
• Retries: Failed deliveries (network errors or non-2xx responses other than the 404 handling below) are retried with exponential backoff (up to 10 attempts).
• 404: If your endpoint repeatedly returns 404, the webhook may be marked inactive after the final attempt so broken URLs do not retry forever.

The JSON body includes matchId, listenerId, organizationId, event (above), platform, timestamps, ai (summary, relevance as 0–100, sentiment, tags, etc.), and platform-specific fields (for example reddit, x, linkedin, or bluesky) when applicable.

For product-focused setup (what webhooks are for in the app), see Webhooks.