Marketing Sources in Mav

What are Marketing Sources? 

A Marketing Source pairs a lead vendor with a playbook and gives you a unique posting URL. Your vendor sends each new lead to that URL as an HTTP POST, and Mav starts the paired playbook on that lead within seconds.

Because the URL identifies both the vendor and the playbook, you create one Marketing Source per combination. Two vendors feeding the same auto playbook means two sources; one vendor feeding both an auto and a home playbook also means two sources. That is what makes per-source reporting possible - every lead arrives already tagged with where it came from.

One vendor, one playbook, one URL

Two ways to create one

• From the directory. Pick a known vendor from Mav's lead source directory, choose the playbook, and the source is named and wired for you. Mav stamps the source and sub-source on every lead automatically, so attribution is consistent and cannot be overwritten by the vendor.
• As a custom source. For a vendor not in the directory, your own landing pages, or a partner feed. You name it yourself, and the vendor may pass its own tracking fields — source, sub_source, sub_id, and the rest of the tracking set — to describe traffic at a finer grain than the source name alone.

How it works

1. Go to Integrations > Marketing Sources

2. Select your source from the directory and click “Integrate”

   1. If your source isn’t listed in the directory, select “My Sources” and choose “New Marketing Source.” Then follow the steps listed below. Be sure to give your source a clear distinctive name.
3. Select the playbook (Home or Auto) where you want to send your leads and click Save & View Instructions

4. You’ll be provided with a postingURL and lead parameters. You can also opt to email the instructions to yourself or a team member.  

5. Send leads to that URL via form or JSON

6. Mav tracks the source automatically and kicks off the follow-up

FIND YOUR POSTING URL

Open Integrations → Marketing Sources → My Sources and click Integration Instructions on the source. The panel shows the posting URL, the exact field list for that source, and a sample request — and the Email Instructions button sends all of it to your vendor in one message.

How to send leads to Mav

Once you have a postURL, leads can be sent in one of two formats: 

1. Form Submission (URL-encoded) 

   1. Send a form submission (like from a website form) using POST to the provided URL. Include fields like:
      first_name=Jane&last_name=Doe&phone=1234567890&email=jane@example.com

2. JSON format 

   1. You can also send leads in JSON format:
      curl -X POST "https://hiremav.com/marketing_sources/acc_2SbUe8xLqEqrL3/mks_kgaafDRBWshCzp" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name":  "Doe",
    "email":      "john.doe@example.com",
    "phone":      "5551234567",
    ...
  }'

Each postURL can accept either format, and Mav will automatically associate the lead with the correct Marketing Source.

Auto and Home accept different fields

The field list is not one universal set. It is chosen by the type of the playbook attached to the source. A home playbook accepts the home list; every other playbook accepts the auto list.

Anything not on the list for that source is dropped. The lead is still created — the post succeeds, no error is returned — but the unrecognized fields never reach the lead record. A vendor sending its auto payload to a home source will look perfectly integrated while the home data quietly disappears.

The same fact, a different name

Several fields exist in both lists under different names. These are the ones worth checking field by field, because the value looks right and lands nowhere.

What only one side has

• Auto only. Every driver and vehicle field, plus marital_status and user_agent. A home source will not keep a single vehicle or driver field.
• Home only. Every property field — roof, stories, square footage, construction, heating, security — plus primary_phone and origin_phone. An auto source will not keep any of them.

Auto Playbook Fields

The four core fields are required on every post. Everything else is optional — and everything else is worth sending. Each field you include is one less question your agent has to ask before it can quote, and one more thing your rep sees the moment a call transfers.

Primary driver

Second driver

Home Playbook Fields

The same four core fields are required. The rest describes the property and the coverage the homeowner is shopping for - the detail that lets Mav qualify before a rep ever picks up.

FIELD REFERENCE · CUSTOM SOURCES