Event Overview
Thewebhook.test.ping event is a special test event that can be triggered from the Pixel Patrol dashboard to verify your webhook endpoint is correctly configured and receiving events.
Test webhooks have a different signature format. The signature is included in the JSON body under
_pixelpatrol_signature instead of the X-PixelPatrol-Signature header.Payload Structure
Payload Fields
Verification Differences
Test webhooks require special handling for signature verification:Testing Your Integration
- Configure Webhook URL: Set your endpoint URL in the Pixel Patrol dashboard
- Add Webhook Secret: Generate and save a secure webhook secret
- Send Test Event: Click “Test Webhook” button in the dashboard
- Verify Receipt: Check your logs for the test event
- Confirm Response: Ensure your endpoint returns 200 OK
Example Response
Your endpoint should return a 2xx status code to indicate successful receipt:Common Issues
- 401 Unauthorized: Signature verification failed - check your webhook secret
- 404 Not Found: Webhook URL is incorrect or not accessible
- 500 Server Error: Your endpoint has an error - check server logs
- Timeout: Endpoint took too long to respond (>30 seconds)