SeerrAPN

SeerrAPN is an APN (Apple Push Notification) service using Seerr's webhooks.

Features

Events supported

• New Request
• Request Denied
• Movie/Show Available
• Request Automatically Approved

Filters

You can make it so that users have only specific notifications:

• None: 0
• New Request: 1
• Request Denied: 2
• Movie/Show Available: 4
• Request Automatically Approved: 8

To filter multiple notifications, simply add the number matching the notification like so:

- Request Denied: 2
- Request Automatically Approved: 8

2 + 8 = 10

You cannot filter out the TEST_NOTIFICATION, accessible by a Seerr administrator.

Running

To make SeerrAPN work follow these steps:

1. Rename the EXAMPLE.env file to .env file
2. Generate an APN Certificate
3. Change the .env file to your wish
4. Run node server/index.js or use Docker Compose with docker-compose.yml
5. Set the Seerr webhook URL as http://localhost:3000/apn (or with your chosen port/URL) and fill in the Authorization Header with the one you chose

Subscribe using Swiftseerr

If you have a running SeerrAPN instance, or if your administrator set up one. You can subscribe to the Seerr notifications using the steps below:

Requirements:

• An iOS device running Swiftseerr
• The SeerrAPN URL for your Seerr instance and the Authorization Header

1. Allow notifications in the Settings app for Swiftseerr
2. Tap the settings icon in the top right corner, and select "Notifications"
3. Type the SeerrAPN URL in the text field with the same name and the Authorization Header in the text field below
4. Tap the purple paperplane button

If the informations written are invalid, or if the SeerrAPN instance has issues, an error on-screen should appear.

---

© Lumaa 2025-2026