How to Test OneSignal Webhooks

OneSignal webhooks fire on push notification events — clicked, displayed, dismissed — across web, mobile, and email channels.

1. OneSignal Webhook Events

OneSignal can send the following webhook events to your endpoint:

2. Set Up a Test Endpoint with HookRay

Follow these steps to start receiving OneSignal webhooks for testing:

1. Go to HookRay and click "Start Testing — Free" to get your unique webhook URL.
2. Copy the URL (e.g., https://h.hookray.com/abc123).
3. In your OneSignal dashboard, navigate to the webhook settings and paste the HookRay URL as your endpoint.
4. Select the events you want to receive (see list above).
5. Trigger a test event — HookRay will show the incoming webhook in real-time.

3. Sample OneSignal Webhook Payload

Here's an example of what a OneSignal webhook payload looks like:

{
  "event": "notification.clicked",
  "id": "5e9f5e5e-5e5e-5e5e-5e5e-5e5e5e5e5e5e",
  "userId": "abcdef12-3456-7890-abcd-ef1234567890",
  "appId": "xyz12345-6789-0abc-def0-123456789abc",
  "timestamp": 1745420900,
  "additionalData": {
    "campaign": "spring-sale-2026",
    "deeplink": "https://example.com/sale"
  }
}

4. Common Issues & Troubleshooting

5. Next Steps

• Use HookRay's webhook replay feature to re-send captured webhooks while building your handler
• Enable smart parsing (Pro plan) to see OneSignal-specific fields highlighted automatically
• Check the OneSignal webhook documentation for the complete event reference