Webhooks

By default the Seerr plugin polls for requests on an interval. Configuring the webhook instead lets Seerr push approved requests to Riven immediately.

Riven validates your Seerr webhook configuration on startup and the plugin fails to load if it is wrong, so it is worth letting Riven configure it for you.

Let Riven configure it (recommended)

RIVEN_PLUGIN_SETTING__REPO_PLUGIN_SEERR__autofixWebhookBody=true

RIVEN_PLUGIN_SETTING__REPO_PLUGIN_SEERR__updateIntervalSeconds=null

Configuring it manually

If you would rather not grant Riven write access to your Seerr settings, leave autofixWebhookBody off and configure the agent yourself.

Enable these two notification types, and only these two:

• Request Approved
• Request Automatically Approved

Riven ignores every other type. Leaving extras enabled works but logs a warning and produces webhook calls that are discarded.

Then set the JSON payload to exactly this:

{
  "query": "mutation ($input: SeerrHandleWebhookInput!) { seerrHandleWebhook(input: $input) }",
  "variables": {
    "input": {
      "payload": {
        "notification_type": "{{notification_type}}",
        "{{media}}": {
          "imdbId": "{{media_imdbid}}",
          "media_type": "{{media_type}}",
          "tmdbId": "{{media_tmdbid}}",
          "tvdbId": "{{media_tvdbid}}"
        },
        "{{request}}": {
          "request_id": "{{request_id}}",
          "requestedBy_email": "{{requestedBy_email}}"
        },
        "{{extra}}": []
      }
    }
  }
}

Verifying

Press Test in Seerr's webhook settings. Riven logs Seerr webhook notification received and returns true. Then approve a real request and watch it enter the pipeline.

Troubleshooting

Invalid Seerr webhook settings — the notification types or the JSON payload don't match. The error lists exactly which. Either fix them by hand or set autofixWebhookBody=true.

Invalid Seerr metadata provider settings — unrelated to webhooks, but it is checked first, so it will mask them. Riven needs both the TV and Anime metadata providers in Seerr set to TVDB. Fix them at Settings → General → Metadata, or set RIVEN_PLUGIN_SETTING__REPO_PLUGIN_SEERR__autofixMetadataProviders=true.

Nothing arrives, no errors — Seerr can't reach Riven. Validation only checks Seerr's stored settings; it never tests the URL. Curl the endpoint from inside the Seerr container:

docker compose exec seerr wget -qO- --post-data '{"query":"{ __typename }"}' \
  --header 'content-type: application/json' http://riven:3000

Received unsupported Seerr notification type — an extra notification type is enabled in Seerr. Harmless; turn it off to quiet the log.