How to Set Up Webhooks
Webhooks let you receive real-time notifications when email events happen — opens, clicks, bounces, replies, and more. OutSends sends event data to your endpoint as JSON payloads.
What you'll need
Before you start, make sure you have the following ready.
- An OutSends account
- A webhook endpoint URL (your server)
- Basic understanding of HTTP and JSON
Step-by-step guide
Follow these steps to complete the setup.
Create your endpoint
Set up a server endpoint (URL) that can receive POST requests with JSON payloads.
Go to Webhooks in Settings
Navigate to Settings > Webhooks. Click "Add Webhook".
Select events to subscribe
Choose which events trigger the webhook: open, click, bounce, reply, unsubscribe, complaint.
Enter your endpoint URL
Paste your endpoint URL. Optionally set a secret for payload signature verification.
Test and verify
OutSends sends a test payload. Verify your endpoint processes it correctly before enabling.
Tips for best results
Pro tips to get the most out of this setup.
- Verify webhook signatures using the secret to ensure payloads come from OutSends
- Respond with 200 OK within 5 seconds — OutSends retries after 3 failures
- Log incoming webhooks for debugging and audit trails
Frequently asked questions
Can I have multiple webhook endpoints?
Yes, you can create as many webhooks as needed, each subscribed to different events.
What format is the webhook payload?
JSON with event type, timestamp, recipient, campaign ID, and event-specific data (link URL for clicks, bounce type for bounces).
Does OutSends retry failed webhooks?
Yes, up to 3 retries with exponential backoff. Your server must respond within 5 seconds.
Related guides
Explore more how-to guides for OutSends.
Ready to get started?
Create a workspace, connect a sender, and launch your first campaign — free, no credit card.