ILS IntegrationProspect Creation

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

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

API Endpoint

ActionEndpointMethodResponse
Create ILS Prospect/external-api/ils-prospectsPOSTJSON

Base URL

https://api-prod.fortresstech.io

Headers

HeaderTypeRequiredDescription
x-api-keystringYesDedicated API key for ILS prospect ingestion.

Request Body

Content type: application/json

FieldTypeFormatRequiredDescription
propertyIdstringuuidYesProperty ID where the prospect should be created.
firstNamestring-YesProspect first name.
lastNamestring-YesProspect last name.
phoneNumberstring-YesProspect phone number.
emailAddressstring-YesProspect email address.
messagestring-YesLead message from the prospect.
nBedsnumber-NoDesired number of bedrooms.
nBathsnumber-NoDesired number of bathrooms.
moveInDatestringdateNoDesired move-in date (YYYY-MM-DD).
preferredUnitstring-NoPreferred unit identifier (for example, 2205D).
preferredFloorPlanIdstringuuidNoPreferred floor plan ID.

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

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

Example Success Response

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

Getting Started

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