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:

RequirementDetails
Webhook configurationThis is usually the issue with email stats not being detected. See troubleshooting steps based on your ESP:
- SendGrid
- Mailgun
- Mandrill
Link Tracking EnabledLink Tracking defaults to always on unless specifically disabled. See Email Links and Click Tracking to verify that is enabled.
Valid CNAME recordThis 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:

2526

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:

3818 1852

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.