# Prospects

Webhook for prospect changes (creates, updates, deletes).
Only the below fields are included in the record and old_record objects.


Endpoint: POST ProspectsEvents
Version: 1.1.1
Security: ApiKeyAuth

## Request fields (application/json):

  - `record` (object)

  - `record.id` (string)
    Unique identifier for the prospect
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `record.created_at` (string)
    When the prospect was created
    Example: "2023-01-15T12:00:00Z"

  - `record.name` (string)
    Prospect's name
    Example: "John Doe"

  - `record.phone` (string)
    Prospect's phone number
    Example: "+15551234567"

  - `record.email` (string)
    Prospect's email address
    Example: "test@gmail.com"

  - `record.unit_of_interest` (string)
    Unit the prospect is interested in
    Example: "123"

  - `record.status` (string)
    Current status of the prospect
    Example: "Showing Scheduled"

  - `record.source` (string)
    Where the prospect came from
    Example: "Zillow"

  - `record.notes` (string)
    Notes about the prospect
    Example: "Interested in 2BR units"

  - `record.prescreened` (boolean)
    Whether the prospect has been prescreened
    Example: true

  - `record.voucher_holder` (boolean)
    Whether the prospect holds a housing voucher

  - `record.normalized_phone_number_generated` (string)
    Normalized phone number if normalizable. Else null.
    Example: "+15551234567"

  - `record.license_number` (string)
    License number if applicable
    Example: "ABC123"

  - `record.prospect_type` (string)
    Type of prospect
    Enum: "Self", "Agent"

  - `record.updated_at` (string)
    When the prospect was last updated
    Example: "2023-01-16T14:30:00Z"

  - `record.assigned_to_user_ids` (array)
    IDs of users assigned to this prospect
    Example: ["123e4567-e89b-12d3-a456-426614174001"]

  - `old_record` (object)

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true