Update Prospect Status

Available by Request

Update the status of an existing prospect. Optionally attach a note describing the reason for the change, which is recorded on the prospect’s activity history. See GET /prospectStatuses for the full catalogue of valid status ids.

This endpoint is part of our evolving API ecosystem. To explore availability for your integration, please contact our team.

<Badge>Available by Request</Badge> Update the status of an existing prospect. Optionally attach a note describing the reason for the change, which is recorded on the prospect's activity history. See `GET /prospectStatuses` for the full catalogue of valid status ids. <Note> This endpoint is part of our evolving API ecosystem. To explore availability for your integration, please contact our team. </Note>

Path parameters

prospectIdstringRequired

The id of the prospect

Request

This endpoint expects an object.

Response

The updated prospect

idstringOptionalformat: "uuid"

propertyIdstringOptionalformat: "uuid"

organizationIdstringOptionalformat: "uuid"

prospectStatusIdstringOptionalformat: "uuid"

firstNamestringOptional

middleNamestringOptional

lastNamestringOptional

preferredNamestringOptional

emailstringOptional

phonestringOptional

idempotencyIdstringOptionalformat: "uuid"

readableIdstringOptional

createdAtdatetimeOptional

updatedAtdatetimeOptional

$	curl -X PUT https://api.fortresstech.io/v1/prospects/prospectId/status \
>	-H "Content-Type: application/json" \
>	-d '{
>	"prospectStatusId": "prospectStatusId"
>	}'

1	{
2	"id": "id",
3	"propertyId": "propertyId",
4	"organizationId": "organizationId",
5	"prospectStatusId": "prospectStatusId",
6	"firstName": "firstName",
7	"middleName": "middleName",
8	"lastName": "lastName",
9	"preferredName": "preferredName",
10	"email": "email",
11	"phone": "phone",
12	"idempotencyId": "idempotencyId",
13	"readableId": "readableId",
14	"createdAt": "2024-01-15T09:30:00Z",
15	"updatedAt": "2024-01-15T09:30:00Z"
16	}