---
title: "Create Prospect With Appointment"
method: POST
path: "/v1/prospect/appointment"
tags: ["Calendar"]
---

# Create Prospect With Appointment

`POST /v1/prospect/appointment`

Create a new prospect with an appointment

## Request body

- CreateProspectAppointmentRequest
  - `prospect` CreateProspectForAppointmentRequest, required
    - `first_name` string
    - `last_name` string
    - `email` string — Valid email address
    - `phone` string — Phone number in E.164 format (e.g. +12025550179)
    - `move_in_date` string, date
    - `bedrooms` integer — Number of bedrooms prospect is interested in
    - `bathrooms` integer — Number of bathrooms prospect is interested in
    - `minimum_budget` integer — Minimum monthly rent budget in USD
    - `maximum_budget` integer — Maximum monthly rent budget in USD
    - `min_lease_length` integer — Minimum desired lease term in months
    - `max_lease_length` integer — Maximum desired lease term in months
    - `vendor_prospect_id` string — External vendor prospect IDIf provided, subsequent webhook events will include this ID.Vendor source is attributed to ID from API credentials
    - `vendor_source` string — Vendor prospect id source.Field can only be set by internal EliseApi user, otherwise it is inferred through API credentials
    - `unit_preference` string[] — List of preferred unit numbers.
    - `floorplan_preference` string[] — List of preferred floorplan names.
    - `tracking_url` string — Tracking URL for marketing attribution
    - `new_inquiry_source_data` InquirySourceData[] — List of inquiry sources with session and tracking information
      - `name` string, required — Name of the inquiry source
      - `session_time` string, date-time, required — Timestamp of the session
      - `tracking_url` string — Tracking URL for marketing attribution
    - `property_id` string, required
    - `source` string, required
  - `appointment` AppointmentRequest, required
    - `tour_type` 'sgt' | 'guided' | 'virtual', required — An enumeration.
    - `appointment_time` string, date-time, required
  - `lead_note` string — Optional note from the lead about the appointment

## Response `200`

Successful Response

- CreateProspectAppointmentResponse
  - `prospect` CreateProspectResponse, required
    - `elise_prospect_id` string, required
  - `appointment` AppointmentResponse, required
    - `appointment_id` string, required
    - `tour_type` 'sgt' | 'guided' | 'virtual', required — An enumeration.
    - `appointment_time` string, date-time, required
    - `status` 'confirmed' | 'cancelled', required — An enumeration.

## Other responses

- `401` — Not Authorized for this endpoint
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/eliseai/apis/elise-api.md) · [All operations](https://skmtc.net/eliseai/apis/elise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eliseai/elise-api/versions/c3e8edfc04a2/schema)