ILS Prospect Creation

Overview

Fortress provides a dedicated endpoint for Internet Listing Services (ILS) to create prospects directly in Fortress. This page explains the request flow, authentication requirements, and expected request/response payloads.

Use your ILS API key for this integration. This key is separate from standard Fortress API keys.

How ILS Prospect Creation Works

Vendor sends a POST request to the ILS prospects endpoint.
Fortress validates the API key and request payload.
Fortress creates a prospect record and returns the created object.

API Endpoint

Action	Endpoint	Method	Response
Create ILS Prospect	`/external-api/ils-prospects`	POST	JSON

Base URL

https://api-prod.fortresstech.io

Headers

Header	Type	Required	Description
`x-api-key`	string	Yes	Dedicated API key for ILS prospect ingestion.

Request Body

Content type: application/json

Field	Type	Format	Description
`propertyId`	string	uuid	Property ID where the prospect should be created.
`firstName`	string	-	Prospect first name.
`lastName`	string	-	Prospect last name.
`phoneNumber`	string	-	Prospect phone number.
`emailAddress`	string	-	Prospect email address.
`nBeds`	number	-	Desired number of bedrooms.
`nBaths`	number	-	Desired number of bathrooms.
`moveInDate`	string	date	Desired move-in date (`YYYY-MM-DD`).
`preferredUnit`	string	-	Preferred unit identifier (for example, `2205D`).
`preferredFloorPlanId`	string	uuid	Preferred floor plan ID.
`message`	string	-	Optional lead message from the prospect.

Example Request (cURL)

curl --location --request POST 'https://api-prod.fortresstech.io/external-api/ils-prospects' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {api-key}' \
--data-raw '{
  "propertyId": "9e539f48-1c18-41a9-8718-1d4ed029f8b5",
  "firstName": "Bob",
  "lastName": "Smith",
  "phoneNumber": "5553211234",
  "emailAddress": "bob@fakemail.com",
  "nBeds": 3,
  "nBaths": 2,
  "moveInDate": "2026-04-15",
  "preferredUnit": "2205D",
  "preferredFloorPlanId": "e513b162-14b5-4808-a016-32ae1abbe9a2",
  "message": "Introductory message"
}'

Responses

Status	Meaning
`200`	Prospect created successfully.
`400`	Bad request (invalid payload).
`401`	Invalid API key.
`409`	Conflict (duplicate or conflicting data).

Example Success Response

{
  "id": "f6d6dba1-8f42-47a5-9db9-9a4bb2f77f1b",
  "propertyId": "2e022332-62d6-4c8a-a7b3-2b4ab641ed12",
  "firstName": "Bob",
  "lastName": "Smith",
  "phoneNumber": "5553211234",
  "emailAddress": "bob@fakemail.com",
  "nBeds": 3,
  "nBaths": 2,
  "moveInDate": "2026-04-15",
  "preferredUnit": "2205D",
  "preferredFloorPlanId": "e513b162-14b5-4808-a016-32ae1abbe9a2",
  "message": "Introductory message"
}

Getting Started

Request onboarding for ILS prospect ingestion and obtain your dedicated API key.
Send a POST request to /external-api/ils-prospects with x-api-key and a valid JSON body.
Store the returned prospect id for traceability in your integration.