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. 1

    Go to Settings — Integrations — Webhooks.

    EasyCRM shows list of configured webhooks with status (Active/Paused/Error).

  2. 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. 3

    Enter name: ERP Sync, URL: https://erp.company.com/api/crm-webhook, selects events: deal.won, invoice.paid.

  4. 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. 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.