How can we help? 👋

Set up a General Use Email Parser for Leads

Use a general email parser to create lead cards from other lead sources.

You can use a general email parser to create lead cards from other lead sources that aren’t in the Aptly Email Parser list (See: Email Parsers). There are a few requirements for the incoming emails, but the General Email Parser setup has the same options that you can find in the Email Parsers article.

In this article, you will learn how to:

  1. Set up your incoming lead emails
  1. Turn on the General Email Parser

How to Set Up Lead Emails

In order for the General Email Parser to work, you’ll need to ensure that the incoming lead emails include the following information.

Subject

The subject of the email must include:

👉
Aptly - Lead - Example: Aptly - Lead - 123 Main Street

From Email

The email can come from any email address. It will not work if you send the email from your inbox to the same inbox. Forwarded emails are also excluded from the General Email Parser.

Email Body

There are many fields that can be parsed from a General Email Parser. They just need to be clearly defined in the email body. The template can be whatever you’d like, however, to extract the data, each data point must be wrapped in this way:

<p>key: value</p>

Below you’ll find a list of supported fields. These fields must also exist on the target board in order for information to be correctly parsed.

Required Fields
Field Names
Contact Name
- First Name & Last Name or - Full Name
One form of contact required.
- email - phone - home phone - mobile phone - work phone

The email can include any of the following fields. The information from these fields will be parsed to the card as long as the fields are also added to the target board.

Optional Fields
Description
aptletCardIsWon
True or omit
aptletCardStage
exact name of the stage
aptletCardName
title of the new card
address
full current address of the new contact
zip
current zip code of new contact
bath count
desired bath count
bed count
desired bed count
comments
single line of comments or notes
company
company name of the contact
credit score
credit score of the contact
income
self-reported income of the contact
lease term
lease term selected by contact
occupant count
number of occupants
pets
single line of pet information
target move in
target move in date
target price range
target price range
tour notes
notes on any requested tour
tour time
time for a requested tour
unit type
notes on a requested unit type
property name
name of the unit/building contact is interested in
property address
street address of unit/building contact is interested in
property city
city of the unit/building
property state
stage of the unit/building
property zip
zip code of the unit/building
property full address
full address (address, city, state, zip) of the unit/building

Sample HTML Email

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title></title>
</head>
<body>
    <h2><strong>Bob Dole</strong> Is Requesting a Tour!</h2>
    <div>
        <p>full name: Bob Dole</p>
        <p>email: bobdole@gmaile.com</p>
        <p>phone: 777-555-4444</p>
        <p>tour notes: Looking to tour some time next week</p>
        <p>aptletCardStage: Tour Requested</p>
        <p>property name: 2125 West Elmside</p>
        <p>comments: Just got a new job in town and moving there soon. Pretty new to the area.</p>
    </div>
</body>
</html>

How to Turn on the General Use Parser

You can add the General Use Parser to any inbox.

Notion image
  1. From the Inbox, click on Inbox Configuration > Inbox Rules.
  1. Select Email Parsers.
  1. Select the inbox and click + Add Parser. If using an inbox without any parsers, click + Add Inbox.
  1. From the Vendors list, locate General Use Parser. Check the box. If you expect the emails to come in with multiple leads within one email, you can also select General Use Parser - Multiple Leads.
  1. Select the Create Card options (See: Email Parsers).
  1. Click Save. The Email Parser will begin to parse emails for any new incoming emails in about 15 minutes.
💡
Email parsers will not work retroactively. For any existing emails in the inbox, you can manually create cards from the email.

Related Articles

Did this answer your question?
😞
😐
🤩