Configure outbound webhooks
An administrator configures outbound webhooks so that the CRM pushes real-time event notifications to external systems when specified events occur.
When this happens: Admin navigates to Settings — Integrations — Webhooks — Add Webhook.
Step by step
- 1
Go to Settings — Integrations — Webhooks.
EasyCRM shows list of configured webhooks with status (Active/Paused/Error).
- 2
Click Add Webhook.
Form: Name, Endpoint URL (HTTPS required), Secret (auto-generated, can be customized), Events to subscribe (checkboxes for 15+ event types: contact.created, contact.updated, lead.created, opportunity.stage_changed, deal.won, deal.lost, invoice.paid, ticket.created, ticket.resolved, etc.).
- 3
Enter name: ERP Sync, URL:
https://erp.company.com/api/crm-webhook, selects events:deal.won,invoice.paid. - 4
Click Test — sends a test payload to the URL.
EasyCRM sends test event. EasyCRM shows result: HTTP 200 OK = Success or HTTP 4xx/5xx = Failed: [status code].
- 5
Click Save Webhook is Active.
When a subscribed event occurs, sends JSON payload to the endpoint, signed with HMAC-SHA256 using the webhook secret.
Other paths
Edit webhook
Select a webhook — Edit Changes subscribed events or URL. Saves.
View delivery log
Open a webhook — Delivery Log EasyCRM shows last 30 days of deliveries: Timestamp, Event Type, HTTP Status, Response Time, Payload (expandable). Can manually retry a failed delivery.
Pause webhook
Toggles webhook to Paused Events for this webhook are queued but not delivered.
If something goes wrong
Endpoint unreachable
Delivery fails (timeout, DNS error, HTTP 5xx). Retries: 3 attempts with exponential backoff (1 min, 5 min, 30 min). After 3 failures, marks delivery as Failed If consecutive failures exceed threshold (10), webhook auto-paused. Admin notification: Webhook 'ERP Sync' has been paused due to repeated failures
Non-https URL
If URL does not start with https://. Validation error: Webhook URL must use HTTPS
Good to know
- Webhook URLs must use HTTPS.
- Payloads are signed with HMAC-SHA256 using the webhook secret for verification by the receiving system.
- Delivery log is retained for 30 days.
- Auto-pause after 10 consecutive delivery failures.