Notifications
Send Notifications
Please take a minute to read the Features & Guidelines. It's important to follow these, otherwise we may disable your ability to send notifications.
To send notifications to users you need to:
- Request permission in the Developer Portal Advanced settings, for your mini app,
- request permission to send notifications from the user, via MiniKit (see Request Permission),
- actually send the notification using our API or the Developer Portal (see How To Send Notifications).
Notifications are queued on our servers, users may not receive them immediately.
Manually sending notifications from Developer Portal
You can send notifications to multiple wallet addresses (up to a thousand) directly from the Developer Portal.
Use the form to input addresses, and content details. Once you click the Send button and get a success response, your notifications will be queued for delivery.
Calling the send-notification endpoint
You can also call our API to send notifications. For detailed information, see the API Reference.
Testing
We currently have a limit of 40 notifications per 4 hours for unverified apps. This is to help you test your notification implementations. Currently you will need to create a new app if your app is verified as it will default to the verified app's metadata. In addition, you need to enable notifications for your mini app inside of World App to receive them.