Webhooks are part of our Enterprise plans. Please contact us if you are interested in this feature.
Nami provides a variety of data generated by use of our platform that can be sent via webhook to your servers or a third-party platform.
See our list of webhooks event types for everything Nami supports.
The webhook payload will always have the following fields:
created_dateISO 8601 format time field for when the event was created
event_typethe hierarchial event type
idunique id for the event
user_idNami's unique user ID associated with the event
Additional data will be available based on the
event_type. Take a look at the webhook event types guide for more details.
Receiving Only the Events you Want
We will be adding new functionality to allow you to subscribe to only the events you wish to receive in the Control Center soon.
For now, you can check the
event_typewhen you process the events to only use the ones you need.
For example, maybe you want to process all
user.subscriptionevents or just
Each payload will continue to retry its send if it receives anything other than a 2xx response from your server. The retry logic has exponential back off and some randomness. On average it will continue to retry once an hour for up to 24-hours before it stops trying to send a particular payload.
Nami Best Practice
Because of the retry logic and the asynchronous nature of the sending of the webhooks there is no guarantee that you will receive each event in time order.
We recommend that you check the time stamp on the data you are receiving. In particular for
user.subscriptionevents, if you've received a more recent event, you can ignore the old one if all you need to know is your user's current subscription status.
Note that we are in the process of improving and expanding our capabilities for delivery data from Nami to you and any 3rd parties you would like to integrate with. While this work is underway, please contact support and provide the URL you would like us to send the webhook data to and we will get it set up for you.
To send data to your endpoint, log in to the Control Center, navigate to the App Settings screen, and enter the URL in the Webhook URL field.
Nami will start sending data to this URL immediately.
We provide a couple of options that you may use to both secure your webhook endpoint and validate that the data you are receiving is coming from Nami.
- Nami hashes the payload of all data sent with HMAC-SHA-256 and a shared secret that is available in our Control Center. The result of this hash is added as
nami-signatureto the header of the request. You can validate that the signature is correct on your end after receiving the data.
Read here for more information on managing the Nami shared secret.
- Nami webhooks come from a fixed IP address so you may explicitly allow traffic from our servers. You can retrieve the current list of IPs to add to your allow list from this endpoint and then look at the array for the key
Nami Best Practice
We recommend that you poll this endpoint on a regular basis and update your system with the latest list of outbound IPs for our webhooks. Once a day should be sufficient.
Updated about a month ago