Create a Prospect

POST

/api/partners/v1/community/{community_id}/prospects/

TODO

Authorizations

• BasicAuth
• BearerAuth

Parameters

Path Parameters

community_id

required

string

The Community ID, this will look like either ‘1234’ or ‘P1234-567’. Alternatively, if you prefix this value with partner-id:, for example partner-id:apts123 you can use your own community, as long as you have previously provided that ID to Funnel.

Examples

Funnel Community ID

The raw integer Funnel ID of a community.

1234

Funnel Community Syndication ID

The community’s Funnel syndcation ID. An ID in this format is often provided in Funnel feeds to ILS partners.

P1234-567

Partner ID

The ID of the community in the partner system. This needs to have been previously provided to Funnel and setup.

partner-id:apts123

Request Body

object

price_floor

string

nullable

people

required

Array<object>

>= 1 items

object

first_name

string

nullable

last_name

string

nullable

is_primary

boolean

nullable

phone_2

string

nullable

email

string

phone_1

string

nullable

price_ceiling

string

nullable

agents

Array<string>

nullable

parking

PARKING_ANY = 10 PARKING_OFF_STREET = 20 PARKING_GARAGE = 30 PARKING_ATTACHED_GARAGE = 35 PARKING_DETACHED_GARAGE = 40 PARKING_COVERED = 45 PARKING_STREET = 50

integer format: int32

nullable

Allowed values: 10 20 30 35 40 45 50

doorman

DOORMAN_NONE = -10 DOORMAN_ANY = 10 DOORMAN_FULL_TIME = 20

integer format: int32

nullable

Allowed values: 20 10 -10

website_app_id

string

nullable

group

string

nullable

sms_opted_in

If you explicitly collect SMS Opt-in consent in a TCPA compliant way, pass true to this field, otherwise leave it out of your submission.

boolean

elevator

boolean

nullable

broker_phone

string

nullable

pets

Array<integer>

nullable

Allowed values: 10 20 30

broker_last_name

string

nullable

current_postal_code

string

nullable

broker_first_name

string

nullable

client_referral

string

nullable

medium

string

nullable

Allowed values: Direct/Manual Appointment Scheduler Lead Capture Widget API Phone Text Guest Card Funnel Website PMS Import ILS Integrations Email Facebook Messenger Chatbot Call Center

laundry

Array<integer>

nullable

Allowed values: 10 20 30

discovery_source

Funnel Discovery Source ID.

string

nullable

123

marketing_email_opt_in

boolean

nullable

outdoor_space

Array<integer>

nullable

Allowed values: 10 20

source_type

string

nullable

broker_email

string

nullable

device

string

nullable

layout

Array<string>

nullable

Allowed values: Loft Studio 1br 2br 3br 4+br

campaign_id

string

nullable

campaign_info

string

nullable

broker_company

string

nullable

neighborhoods

Array<string>

nullable

notes

string

nullable

website_session_id

string

nullable

lead_source

Funnel Discovery Source ID.

string

nullable

123

website_user_id

string

nullable

move_in_date

string format: date

nullable

Responses

200

Client successfully created/updated.

400

401

403

We were unable to authenticate your request with the provided API key.

object

error_type

string

CommunityNotFound

message

string

Could not find community with corresponding ID.

404

A community or prospect with this ID does not exist.

object

error_type

string

ProspectNotFound

message

string

Could not find prospect with prospect ID.