For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact us
  • Introduction
    • Get Started
    • Authentication
    • Conventions
    • Filtering with FQL
    • Release Notes
  • API Reference
    • Activities
    • Amenities
    • Applications
    • Buildings
    • Customers
    • Deposits
    • Floor Plans
    • Households
    • Income Limits
    • Leases
    • Listings
    • Maintenance
    • Move Ins
    • Move Outs
    • Properties
    • Prospects
    • Rent Changes
    • Reports
    • Reversals
    • Scheduled Reports
    • Scheduled Transactions
    • Screenings
    • Transactions
    • Turns
    • Units
    • Users
    • Work Orders
  • ILS Integration
      • API Reference
Contact us
LogoLogo
On this page
  • Overview
  • How ILS Prospect Creation Works
  • API Endpoint
  • Base URL
  • Headers
  • Request Body
  • Example Request (cURL)
  • Responses
  • Example Success Response
  • Getting Started
ILS IntegrationProspect Creation

ILS Prospect Creation

Was this page helpful?
Previous
Built with

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

FieldTypeFormatDescription
propertyIdstringuuidProperty ID where the prospect should be created.
firstNamestring-Prospect first name.
lastNamestring-Prospect last name.
phoneNumberstring-Prospect phone number.
emailAddressstring-Prospect email address.
nBedsnumber-Desired number of bedrooms.
nBathsnumber-Desired number of bathrooms.
moveInDatestringdateDesired move-in date (YYYY-MM-DD).
preferredUnitstring-Preferred unit identifier (for example, 2205D).
preferredFloorPlanIdstringuuidPreferred floor plan ID.
messagestring-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

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.