> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.fortresstech.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.fortresstech.io/_mcp/server.

# 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.

> **Note**
>
> 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

| 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)

```bash
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

```json
{
  "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

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.