Webhooks & Email Stats
Webhook setup and troubleshooting why email analytics not showing in OneSignal.
Email analytics like clicks, opens and unsubscribes require 3 items to be set properly:
Requirement | Details |
---|---|
Webhook configuration | This is usually the issue with email stats not being detected. See troubleshooting steps based on your ESP: - SendGrid - Mailgun - Mandrill |
Link Tracking Enabled | Link Tracking defaults to always on unless specifically disabled. See Email Links and Click Tracking to verify that is enabled. |
Valid CNAME record | This is part of the setup process and is not required for sending emails, but is required for click, open, and unsubscribe tracking. Check with your ESP and DNS provider that the CNAME is verified. |
Webhook Configuration
Webhooks are often used for things like analytics integrations as they allow access to email delivery statistics, and are sent from your email service provider to OneSignal. To simplify setup, OneSignal will automatically configure Webhooks when possible with your email provider. If you already have a Webhook setup and you don't need it, you should first disable it in your email service provider before continuing.
SendGrid Webhook Troubleshooting
Within SendGrid Settings > Mail Settings. Make sure Event Settings > Event Webhook is Enabled.
This should be pointing to https://onesignal.com/email/hooks/sendgrid
and have the minimum settings shown:
Also make sure you have granted Full Access to the API key or at least enabled Full Access to the Tracking events shown in the SendGrid Setup.
Mailgun Webhook Troubleshooting
Within Mailgun Sending > Webhooks > Your Domain > Webhooks or Legacy Webhooks.
This should be pointing to https://onesignal.com/email/hooks/mailgun
Mandrill Webhook Troubleshooting
Within Mandrill > Settings > Webhooks make sure you have a hooked into OneSignal's endpoint https://onesignal.com/email/hooks/mandrill
with the following settings:
FAQ
How do I set up OneSignal if I already have an active Webhook?
You can continue to use your custom webhook but should then forward the request to OneSignal's Webhook URLs. Setup a timeout of 30 seconds for best results.
OneSignal Webhook URLs:
- Mailgun:
https://onesignal.com/email/hooks/mailgun
- Sendgrid:
https://onesignal.com/email/hooks/sendgrid
- Mailchimp/Mandrill:
https://onesignal.com/email/hooks/mandrill
If you need assistance setting up multiple webhooks then the Webhooks by Zapier Integrations is a good solution. Use Zapier's Catch Hook trigger to as the POST URL for the webhook in your ESP. Then setup as many POST webhook actions needed to hit all your webhook URLs including OneSignal's listed above.
Updated about 2 months ago