EasyAgentIDX

Webhooks

Webhooks let you receive real-time HTTP notifications when events occur in your EasyAgentIDX account. Use them to sync leads with your CRM, trigger automations, or build custom workflows.

Available events

  • lead.created - a new lead was captured through any widget.
  • lead.updated - an existing lead record was modified in the dashboard.
  • valuation.created - a homeowner or API request completed an AHV valuation.
  • search.saved - a registered visitor saved a property search.
  • visitor.registered - a visitor created an account through a widget registration gate.

Registering an endpoint

  1. Navigate to Developer - Webhooks.
  2. Click Add Webhook.
  3. Paste your POST URL. The URL must be publicly accessible and respond with a 2xx status code.
  4. Select the events you want to receive.
  5. Save the endpoint and copy its signing secret immediately.

Payload envelope

{
  "event": "lead.created",
  "timestamp": "2026-08-25T18:30:00Z",
  "data": {
    "id": "lead_abc123",
    "name": "Jane Smith",
    "email": "jane@example.com",
    "phone": "+1 (619) 555-0123",
    "source": "Search Widget",
    "property_address": "7542 Draper Ave, La Jolla, CA 92037",
    "created_at": "2026-08-25T18:30:00Z"
  }
}

Signature verification

Every webhook request includes signature, timestamp, event, and delivery ID headers. Verify the timestamp and HMAC before parsing or processing the payload.

Your webhook secret is shown once when you create the endpoint. Store it in an environment variable, not in your source code.

Retry policy

If your endpoint returns a non-2xx response or times out (after 10 seconds), EasyAgentIDX retries the delivery up to 3 times after approximately 1 minute, 5 minutes, and 15 minutes. Use the stable delivery ID for idempotency.

See the Developer Platform webhook guide for the complete signing algorithm, security requirements, and server example.

PreviousOverviewNextZapier