# finder.submitted

> The ByDomu finder.submitted event (Search submitted from the website): when it fires, how to subscribe, its fields and the payload delivered by webhook.


Search submitted from the website

Object · finder Includes · contact Instant

## 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.submitted` Only this event
- `finder.*` Every event of Website finder
- `*` The whole catalog

## Fields it carries

paths for filters and templates

`finder.contactId` Contact

`finder.preferences` What they’re looking for

`contact.id` Contact id

`contact.code` Contact code

`contact.firstName` First name

`contact.lastName` Last name

`contact.email` Email

`contact.phone` Phone

`contact.source` Source

`contact.status` Status

`contact.type` Contact type

`contact.score` Score

`contact.ownerId` Owner

`contact.preferredCity` City of interest

`contact.preferredType` Property type they want

`contact.budget` Budget

`contact.tags` Tags

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.

Payload:

```
{
  "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"
    }
  }
}
```

Headers:

```
X-Domu-Event: finder.submitted
X-Domu-Signature: t=1790610130,v1=9c1e…
User-Agent: Domu-Webhooks/2
```

Verify signature:

```
import { createHmac, timingSafeEqual } from "node:crypto";

// header = X-Domu-Signature: t=<timestamp>,v1=<hmac>
function verifyWebhook(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const timestamp = Number(parts.t);
  if (!timestamp || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSec) return false;
  const expected = createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  return a.length === b.length && timingSafeEqual(a, b);
}
```

**Get it with your test data** GET /v1/webhooks/sample/finder.submitted

[Try it](https://developers.bydomu.com/en/referencia/get-webhook-sample?probar=1&type=finder.submitted)