Marketing Sources: Custom PostURLs for Lead Tracking

Create named postURLs that tag incoming leads by source automatically, so you can measure which vendors and campaigns drive qualified pipeline in Mav.

Marketing Sources lets you generate a unique postURL for each lead source—vendor, affiliate, web form, or campaign—and route leads directly into a specific Mav playbook. Because every URL is tied to a named source, Mav automatically tags each incoming lead so you can see attribution and performance data without any manual tracking.

How it works

1. Open Marketing Sources

   Go to Integrations → Marketing Sources.

2. Create a new source

   Click New Marketing Source.

3. Configure the source

   Give your source a clear, descriptive name, select the source type, and choose the playbook you want leads routed to.

4. Save and copy your postURL

   Click Save Marketing Source. Mav generates a unique postURL for this source. Copy it to use in your form or integration.

5. View integration instructions

   Click the link icon next to the source to open the Integration Instructions panel. It shows the exact URL and the accepted field names.

6. Start sending leads

   Point your lead vendor, form, or integration at the postURL. Mav begins receiving leads and tagging them to this source automatically.

How to send leads to Mav

You can POST leads to your Marketing Source URL in two formats.

Form submission (URL-encoded)

Send a standard HTML form POST with application/x-www-form-urlencoded encoding. The example below shows a minimal subset of fields for illustration—your actual payload must include all required fields listed in the Required fields section below.

POST https://hiremav.com/marketing_sources/acc_2SbUe8xLqEqrL3/mks_kgaafDRBWshCzp
Content-Type: application/x-www-form-urlencoded

first_name=Jane&last_name=Doe&phone=5551234567&email=[e-mail]&...

JSON

Send a POST request with a JSON body and the Content-Type: application/json header. The example below includes all required fields:

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": "[e-mail]",
    "phone": "5551234567",
    "current_insurance_carrier": "State Farm",
    "current_insurance_coverage": "liability",
    "current_residence_address": "123 Main St",
    "current_residence_city": "Austin",
    "current_residence_state": "TX",
    "current_residence_zip": "78701",
    "date_of_birth": "1985-06-15",
    "gender": "male",
    "marital_status": "married",
    "credit_rating": "good",
    "tcpa_opt_in_token": "abc123leadi-d-token",
    "tcpa_opt_in_url": "https://www.example.com/auto-insurance-quote"
  }'

The URL above is an example. Your actual postURL will contain the account and source identifiers generated when you save your Marketing Source. Replace the placeholder field values with your lead’s real data.

Required fields

The following fields must be included in every lead payload. Missing required fields will cause the lead to be rejected.

first_name · string · required

The lead’s first name.

last_name · string · required

The lead’s last name.

email · string · required

The lead’s email address.

phone · string · required

The lead’s phone number. Used to initiate SMS outreach and determine the lead’s local time zone for texting hours.

current_insurance_carrier · string · required

The lead’s current insurance carrier name.

current_insurance_coverage · string · required

The lead’s current coverage type or level.

current_residence_address · string · required

The lead’s current street address.

current_residence_city · string · required

The city of the lead’s current residence.

current_residence_state · string · required

The two-letter state abbreviation for the lead’s current residence (e.g., TX).

current_residence_zip · string · required

The ZIP code of the lead’s current residence.

date_of_birth · string · required

The lead’s date of birth. Recommended format: YYYY-MM-DD.

gender · string · required

The lead’s gender.

marital_status · string · required

The lead’s marital status (e.g., single, married).

credit_rating · string · required

The lead’s self-reported credit rating (e.g., excellent, good, fair, poor).

tcpa_opt_in_token · string · required

A Jornaya LeadiD, ActiveProspect TrustedForm certificate ID, or equivalent token that documents the lead’s TCPA consent at the time of form submission.

tcpa_opt_in_url · string · required

The URL of the page where the lead provided TCPA consent. Used alongside tcpa_opt_in_token as proof of consent.

You are responsible for ensuring that every lead you send to Mav has given written or electronic consent to be contacted via automated SMS and voice calls. Always include tcpa_opt_in_token and tcpa_opt_in_url to document that consent.