ByDomuDevelopers

referral.created

New referral

Object · referralInstant

When it fires

Someone referred a person.

Instantly, when it happens in ByDomu: from the app, the API, Noa, an automation or an integration. actor.kind tells you who: USER, NOA, SYSTEM, API, AUTOMATION or INTEGRATION.

Subscribe with

  • referral.createdOnly this event
  • referral.*Every event of Referral
  • *The whole catalog

Fields it carries

paths for filters and templates
referral.idReferral id
referral.statusReferral status
referral.leadNameReferred name
referral.leadPhoneReferred phone
referral.referredContactIdReferred contact

Up to 5 attempts (0 s, 5 s, 30 s, 2 min and 10 min) on network errors, 429 or 5xx. Reply 2xx in under 10 s.

{
  "event": "referral.created",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "referral.created",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "SYSTEM",
    "userId": null
  },
  "data": {
    "referral": {
      "id": "clx1ref001",
      "status": "PENDING",
      "leadName": "Sofía Herrera",
      "leadPhone": "+573000000004",
      "leadEmail": "[email protected]",
      "referredContactId": null,
      "dealId": null,
      "createdAt": "2026-09-22T14:30:00.000Z"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/referral.created
Try it