Webhooks & n8n

Orion can POST to a webhook URL the moment a followed episode, movie, or game releases. It’s 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 per enabled lead time (see “Notification preferences” below):

{
  "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:lead1d"
}

type: "episode", "movie", or "game". Route on it if you want different handling per media type.
item_key: stable per release and lead time, useful as a deduplication or notification tag. The :lead2d/:lead1d/:lead0d suffix means the same release can arrive under two different item_keys (for example a day before heads up and a day of reminder). If your automation keys off item_key for its own dedup, match on the full string including the suffix, not just the part before it.
poster: full image URL, ready to attach to a notification.

Notification preferences

Settings → For developers → Webhook notifications controls whether this fires at all, and which lead times trigger it. It’s independent from the Android app’s own push preferences, since each channel has its own on/off toggle and lead times. Turn it off, or uncheck every lead time, and nothing gets POSTed, no matter what the webhook URL below is set to.

Configuring your webhook URL

Open Settings → For developers → Notification webhook, paste your webhook URL, and tap Save. The URL must be https:// and can’t point at a private or loopback address (localhost, LAN IPs, cloud metadata endpoints). Orion validates this both when you save it and again each time it sends a notification.

Leave the field empty and tap Save (shown as Clear once a URL is set) to remove your webhook.

n8n

Point the webhook at an n8n Webhook node (method POST) and the payload above arrives as body. From there, route to Telegram, Discord, or 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.