Webhooks
Send real-time visitor data to any endpoint with webhooks. Build custom integrations and power your own applications with Snitcher data.
Key features
- Real-time data delivery
- Custom endpoints
- Flexible payload format
- Retry logic
- Event filtering
Use cases
- Build custom integrations
- Power internal tools with visitor data
- Sync to data warehouses
- Trigger custom automation
Overview
Webhooks allow you to send Snitcher data to any HTTP endpoint in real-time. Perfect for developers who want to build custom integrations or power internal applications with visitor data.
How it works
- Configure your webhook endpoint in Snitcher
- When a visitor matches your criteria, Snitcher sends a POST request
- Your endpoint receives the visitor data in JSON format
- Process the data in your application
Payload Format
{
"event": "visitor.identified",
"timestamp": "2024-01-15T10:30:00Z",
"visitor": {
"company": {
"name": "Acme Inc",
"domain": "acme.com",
"industry": "Technology",
"employees": "51-200",
"country": "United States"
},
"session": {
"pages_viewed": 5,
"duration": 180,
"source": "google",
"landing_page": "/pricing"
}
}
}Setup
- Navigate to Settings → Integrations in Snitcher
- Click Configure next to Webhooks
- Enter your endpoint URL
- Configure event filters
- Test the webhook with sample data
Best Practices
- Implement idempotency in your endpoint
- Return a 200 status quickly to avoid timeouts
- Process data asynchronously for complex operations
- Monitor webhook delivery in the Snitcher dashboard
