Webhook Integration Guide
Set up webhooks to integrate WarmySender with your CRM and automation tools.
What Are Webhooks?
Webhooks are real-time HTTP notifications sent from WarmySender to your endpoint whenever specific events occur (reply received, bounced, unsubscribed, etc.).
Setup (5 minutes):
- Go to Settings > Webhooks.
- Click 'Create Webhook'.
- Enter your endpoint URL (where WarmySender sends the event data).
- Select which events to subscribe to.
- Copy the webhook secret for signature verification.
- Click 'Test' to send a test event and verify your endpoint.
Available Events:
- reply.received — Triggered when a prospect replies to a campaign email.
- email.bounced — Triggered when an email hard-bounces.
- email.unsubscribed — Triggered when a prospect clicks the unsubscribe link.
- email.opened — Triggered when a prospect opens a campaign email (first open per campaign).
- email.clicked — Triggered when a prospect clicks a tracked link (first click per link per day).
- prospect.suppressed — Triggered when a prospect is added to the suppression list.
- limit.hit — Triggered when a daily sending limit is reached (mailbox, domain, or plan).
Payload Format:
Each webhook delivers a signed JSON payload via HTTP POST:
{
'type': 'reply.received',
'data': {
'prospectId': '...',
'prospectEmail': '[email protected]',
'campaignId': '...',
'receivedAt': '2026-03-15T10:30:00Z'
},
'timestamp': '2026-03-15T10:30:00Z'
}
Security Headers:
- X-Warmy-Signature — HMAC-SHA256 signature for payload verification.
- X-Warmy-Event-Type — The event type (e.g., reply.received).
- X-Warmy-Event-Id — Unique event ID for deduplication.
Integration Examples:
CRM Sync (HubSpot, Salesforce, Pipedrive):
- Subscribe to reply.received and email.bounced events.
- On reply: create or update a CRM contact, log the interaction, create a task for follow-up.
- On bounce: update contact status to invalid.
Slack/Teams Notifications:
- Subscribe to reply.received.
- Post to a sales channel when a prospect replies for real-time team awareness.
Zapier / Make / n8n:
- Use these automation platforms as your webhook endpoint.
- Create workflows that trigger actions in any of 5,000+ apps.
- Example: Reply received → Create HubSpot deal → Notify Slack → Add to Google Sheet.
Retry Policy:
Failed deliveries (non-200 responses) are retried up to 10 times with exponential backoff (1min, 5min, 15min, 1hr, 3hr, 6hr, 12hr, 24hr, 48hr, 72hr). Check delivery history in Settings > Webhooks.
Best Practice: Start with reply.received — it is the highest-value event for sales teams. Add more events as your integration matures.