Send Notifications to Mini App Users
Debug Notifications
A guide to debug the mini app notifications service if you are experiencing issues where notifications are not sending properly.
How to debug
- Step 1: First, remove your miniapp. Then re-add it and re-enable notifications. Afterwards, retry notifications and send to yourself.
- Step 2: Test notifications with another user. Send them the miniapp link, confirm the receiving user has enabled notifications for their Farcaster account, and then try sending another notification just to their FID.
- Step 3: If the previous two steps have not resolved your situation, please reach out to our Developer Slack for support. In your Slack message, please share a screenshot of the console (right click on page, then click “inspect”).
FAQ
Why am I not receiving a notification?
Why am I not receiving a notification?
Developers often test enabling notifications with their own account using a localtunnel or ngrok domain (sometimes without even realizing they’ve enabled notifications on their test URL). When developers change their domain to a Vercel domain or something else, their notification token becomes invalid and results in failures from Farcaster’s servers (usually an “invalid domain” error).
Why are only some users receiving notifications?
Why are only some users receiving notifications?
Please see response to “Why am I not receiving a notification?” above. Additionally, there are instances where a user may be on an old mini app domain that has phased out. Users who do receive notifications are usually on the most recent domain.