Webhooks & n8n

Orion can POST to a webhook URL the moment a followed episode, movie, or game releases — the building block for Home Assistant push notifications, n8n flows, or any automation that accepts an HTTP callback.

The payload

Orion checks for new releases every 30 minutes and sends one POST per release:

{
  "type": "episode",
  "title": "Severance",
  "subtitle": "S02E05 · Trojan's Horse",
  "air_date": "2025-02-14",
  "poster": "https://image.tmdb.org/t/p/w342/....jpg",
  "item_key": "episode:1234"
}

• type — "episode", "movie", or "game"; route on it if you want different handling per media type.
• item_key — stable per release; useful as a deduplication/notification tag.
• poster — full image URL, ready to attach to a notification.

Configuring your webhook URL

Your webhook’s status is shown in Settings → Notification webhook.

Note

Self-serve editing of the webhook URL from Settings is still rolling out. If the Settings screen doesn’t offer an edit field yet, webhook delivery isn’t available on your account yet — the Android app’s built-in notifications and Home Assistant sensors don’t need it and work today.

n8n

Point the webhook at an n8n Webhook node (method POST) and the payload above arrives as body. From there, route to Telegram, Discord, email — anything n8n can reach.

Home Assistant

See the dedicated Home Assistant guide for a ready-to-paste automation that turns these webhooks into phone notifications with posters.