ByDomuDevelopers
Create key

finder.submitted

Search submitted from the website

Object · finderIncludes · contactInstant

When it fires

Someone used the guided finder (POST /v1/finder). finder carries the contact id and the matching listings.

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

  • finder.submittedOnly this event
  • finder.*Every event of Website finder
  • *The whole catalog

Fields it carries

paths for filters and templates
finder.contactIdContact
finder.preferencesWhat they’re looking for
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

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": "FINDER_SUBMITTED",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "finder.submitted",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "API",
    "userId": null
  },
  "data": {
    "finder": {
      "contact": {
        "id": "clx1con009"
      },
      "properties": [
        {
          "id": "clx1prop001",
          "code": "P-0042",
          "title": "Apartamento en Chapinero Alto con balcón",
          "type": "APARTMENT",
          "transactionType": "SALE",
          "price": 450000000,
          "currency": "COP",
          "city": "Bogotá",
          "neighborhood": "Chapinero Alto",
          "bedrooms": 3,
          "bathrooms": 2,
          "area": 85,
          "matchScore": 87,
          "breakdown": [
            {
              "criterio": "presupuesto",
              "puntos": 30,
              "estado": "match"
            },
            {
              "criterio": "barrio",
              "puntos": 20,
              "estado": "match"
            },
            {
              "criterio": "habitaciones",
              "puntos": 15,
              "estado": "match"
            }
          ],
          "image": "https://cdn.bydomu.com/props/clx1prop001/1.jpg"
        }
      ],
      "total": 1,
      "source": "api"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/finder.submitted
Try it