ByDomuDevelopers

lease.created

Lease created

Object · leaseIncludes · contactIncludes · propertyInstant

When it fires

A lease was created. Carries the lease, the tenant (contact) and the listing.

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

  • lease.createdOnly this event
  • lease.*Every event of Lease
  • *The whole catalog

Fields it carries

paths for filters and templates
lease.idLease id
lease.codeLease code
lease.statusLease status
lease.startDateLease start
lease.endDateLease end
lease.monthlyRentMonthly rent
lease.currencyCurrency
lease.propertyIdListing
lease.tenantIdTenant
lease.ownerIdOwner
lease.managerIdManager
lease.daysToEndDays to expiry
contact.idContact id
contact.codeContact code
contact.firstNameFirst name
contact.lastNameLast name
contact.emailEmail
contact.phonePhone
contact.sourceSource
contact.statusStatus
contact.typeContact type
contact.scoreScore
contact.ownerIdOwner
contact.preferredCityCity of interest
contact.preferredTypeProperty type they want
contact.budgetBudget
contact.tagsTags
property.idListing id
property.codeListing code
property.titleListing title
property.typeProperty type
property.transactionTypeOperation
property.statusListing status
property.priceSale price
property.rentPriceRent price
property.currencyCurrency
property.cityCity
property.neighborhoodNeighborhood
property.bedroomsBedrooms
property.bathroomsBathrooms
property.areaArea
property.agentIdAgent
property.previousPricePrevious price
property.previousStatusPrevious status

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": "lease.created",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "lease.created",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "SYSTEM",
    "userId": null
  },
  "data": {
    "lease": {
      "id": "clx1lea001",
      "code": "A-0007",
      "status": "DRAFT",
      "startDate": "2025-11-01T00:00:00.000Z",
      "endDate": "2026-10-31T00:00:00.000Z",
      "daysToEnd": 395,
      "monthlyRent": 3200000,
      "adminFee": 380000,
      "currency": "COP",
      "paymentDayOfMonth": 5,
      "propertyId": "clx1prop002",
      "tenantId": "clx1con002",
      "ownerId": "clx1con003",
      "managerId": "clx1usr001",
      "createdAt": "2025-10-28T19:00:00.000Z"
    },
    "contact": {
      "id": "clx1con002",
      "code": "C-0043",
      "firstName": "Camilo",
      "lastName": "Duarte",
      "fullName": "Camilo Duarte",
      "email": "[email protected]",
      "phone": "+573000000002",
      "source": "REFERRAL",
      "status": "WON",
      "type": "CLIENT",
      "score": 90,
      "ownerId": "clx1usr001",
      "preferredCity": "Medellín",
      "preferredType": "APARTMENT",
      "budget": 3200000,
      "currency": "COP",
      "tags": [
        "Arrendatario"
      ],
      "createdAt": "2025-11-02T13:00:00.000Z"
    },
    "property": {
      "id": "clx1prop002",
      "code": "P-0057",
      "title": "Apartamento en El Poblado cerca a la estación",
      "type": "APARTMENT",
      "transactionType": "RENT",
      "status": "RENTED",
      "price": null,
      "rentPrice": 3200000,
      "currency": "COP",
      "city": "Medellín",
      "neighborhood": "El Poblado",
      "address": "Cl 10 #43-20",
      "bedrooms": 2,
      "bathrooms": 2,
      "area": 68,
      "agentId": "clx1usr001",
      "createdAt": "2025-10-20T14:00:00.000Z"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/lease.created
Try it