Scope: write:enquiries
The replacement for V1's marketing/enquiries/seller. There is no property yet, so the
request belongs to a team. A team scoped key writes to its own team, so teamId may be
omitted; if supplied it must match. A client or network scoped key must supply
teamId, and it must be a team the key can reach.
Up to three preferredTimes (the appraisal slots asked for) are written into the
request's comment after the visitor's own comment, as V1 writes them, in UK time.
salesValuation and rentalValuation carry any estimates from the website's
valuation tool. propertyType and bedrooms (0 to 50) are written into the
comment after the appraisal heading, as a seller enquiry has nowhere else to keep them.
Either firstName or lastName, and either emailAddress or
phoneDaytime, are required.
The team's beacon and a push to agents' phones follow, as for a portal lead; neither can
fail the request.
POST /v2/sales/valuation-requests
{
"teamId": "11111111-1111-1111-1111-111111111111",
"firstName": "Sam",
"lastName": "Example",
"emailAddress": "[email protected]",
"address": "1 Example Street, Exampletown",
"postcode": "EX1 1AA",
"propertyType": "semiDetached",
"bedrooms": 3,
"preferredTimes": ["2026-11-09T09:30:00Z"],
"salesValuation": { "min": 240000, "value": 250000, "max": 265000 }
}
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
