Skip to main content

Creating a Lead with Metadata (Google Ads Tracking)

Updated today

To create a lead in Movermate, you need to send a POST request to the webhook endpoint with all required lead details.
​

If the lead is generated from marketing platforms (such as Google Ads), you must include a metadata object containing tracking parameters like gclid and UTM fields.
​

This ensures accurate tracking, attribution, and reporting of your campaigns.

POST https://server.movermate.com.au/webhook/leads

Lead Data Structure

The request should include:

Basic Details

Job Details

Additional Fields

Inventory (Optional)

  • firstName

  • lastName

  • email

  • phone

  • date

  • pickup

  • dropoff

  • jobType

  • jobCategory

  • moveSize

  • furnishedType

  • timeSlot

  • tags

  • note

  • bookingNotes

  • branch

  • leadStatus

You can pass multiple inventory items with:

  • category

  • name

  • quantity

  • dimensions

  • volume (optional)

Metadata (Important for Ads Tracking)

You must include a metadata object in your request.

Key Fields

  • gclid β†’ Required for Google Ads tracking

  • utm_source

  • utm_medium

  • utm_campaign

  • utm_term

  • utm_content

Optional Tracking Fields

  • gbraid (Google Ads iOS tracking)

  • fbclid (Facebook tracking)

  • msclkid (Microsoft Ads tracking)

Example Request

{
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"alternateEmails": "[email protected], [email protected]",
"date": "2025-01-01",
"phone": "8888888888",
"alternatePhones": "8888888881, 8888888882",
"pickup": "Brisbane",
"dropoff": "Queensland",
"source": "Website",
"timeSlot": "Morning",
"note": "This job is received through a referral.",
"jobType": "Commercial Moving",
"jobCategory": "Moving",
"moveSize": "2 Bedroom",
"furnishedType": "Lightly Furnished",
"tags": "Premium Move, Luxury Furniture",
"bookingNotes": "This is a booking note for the job.",
"branch": "Branch 1",
"leadStatus": "New",
"inventoryItems": [
{
"category": "Dining",
"name": "Dining Chair",
"quantity": 1,
"dimensions": { "heightCm": 50, "widthCm": 45, "depthCm": 70 },
"volumeCubicMeters": 0.0158
}
],
"metadata": {
"utm_source": "sample",
"utm_medium": "sample",
"utm_campaign": "sample",
"utm_term": "sample",
"utm_content": "sample",
"gclid": "sample",
"gbraid": "sample",
"fbclid": "sample",
"msclkid": "sample"
}
}

How Metadata Works

  1. A user clicks on your ad (Google, Facebook, etc.)

  2. Tracking parameters (like gclid, utm_*) are added to the URL

  3. Your website or integration captures these values

  4. These values are sent in the metadata object

  5. Movermate stores them with the lead

Important Notes

  1. gclid is mandatory for Google Ads conversion tracking

  2. Always pass metadata exactly as received (do not modify values)

  3. Ensure proper formatting (no invalid JSON)

  4. Missing metadata may result in loss of campaign tracking

Outcome

By including metadata:

  1. You can track lead sources accurately

  2. Measure campaign performance

  3. Optimize ad spend

  4. Improve reporting inside Movermate

For any inquiries, please reach out to the Movermate Product Experts at [email protected].We're here to help!


​

Did this answer your question?