Adding Leads via Email

By sending emails to Funnel lead forwarding emails, and including the following structured data, you can insert leads into Funnel via email. The lead forwarding emails are unique per community and lead source. Go to Settings > Marketing > Prospect Email Forwarding in Funnel to see the lead forwarding email addresses for your communities, or create new lead forwarding email addresses.

Supported formats

Prospect details can be embedded inside an email using one of the following formats:

Hidden div
HTML comment

Hidden div

Insert a hidden <div> HTML element into the email body. This div must have the id prospect-details. To hide this element add the below CSS as an inline style using the style attribute: display: none;. The element text content must be the lead as a single JSON object.

HTML comment

Insert an HTML comment into the email body. This HTML comment must start with the string PROSPECT = followed by the lead as a single JSON object.

Examples

Hidden div

<div style="display: none;" id="prospect-details">
{
    "name": "Johnny Example",
    "email": "johnny@example.com",
    "phone": "567-567-5678",
    "minPrice": "$1000",
    "maxPrice": "$2000",
    "moveInDate": "2025-06-07",
    "layouts": ["1BED", "STUDIO"],
    "notes": "Do you allow pets?",
    "unit": "82021",
    "sms_opt_in": "true"
}
</div>

HTML comment

<!-- PROSPECT = {
    "name": "Johnny Example",
    "email": "johnny@example.com",
    "phone": "567-567-5678",
    "minPrice": "$1000",
    "maxPrice": "$2000",
    "moveInDate": "2025-06-07",
    "layouts": ["1BED", "STUDIO"],
    "notes": "Do you allow pets?",
    "unit": "82021",
    "sms_opt_in": "true"
} -->

Technical details for developers

This section covers technical details meant to help developers integrate with prospect email forwarding.

Use inline CSS for hidden div

Important CSS style must be inlined, as <style> tags are stripped by most email service providers. So the following <div> will be displayed by most email service providers.

Warning! Do NOT use a CSS class to hide the div. Do NOT do the following:

<style>
.hidden {
    display: none;
}
</style>
<div class="hidden" id="prospect-details">
{
    ...
}
</div>

JSON prospect schema

Key	Value type	Is required
name	string	Yes
email	string	Yes
phone	string	No
minPrice	string	No
maxPrice	string	No
moveInDate	ISO 8601 date string	No
layouts	array of strings	No
notes	string	No
unit	string	No
[sms_opt_in]	bool	No

Name

The full name of the prospect.

Email

The email address of the prospect.

Phone

The phone number of the prospect.

Min price

The minimum price the prospect is willing to pay.

Max price

The maximum price the prospect is willing to pay.

Move-in date

The date the prospect wants to move in. Move-in date must be a date in ISO 8601 format: YYYY-MM-DD

Layouts

The property layouts of interest to the prospect. Layouts is a JSON array of strings. Supported layouts:

"STUDIO"
"1BED"
"2BED"
"3BED"
"4BED"
"5BED"
"6BED_OR_MORE"

Notes

A string that will be used as the lead’s ‘message’

Unit

A string representing the unit number the prospect is referencing.

SMS Opt-in

A bool representing the prospect’s sms opt-in response.