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) |
|
|
| You can pass multiple inventory items with:
|
Metadata (Important for Ads Tracking)
You must include a metadata object in your request.
Key Fields
gclidβ Required for Google Ads trackingutm_sourceutm_mediumutm_campaignutm_termutm_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
A user clicks on your ad (Google, Facebook, etc.)
Tracking parameters (like
gclid,utm_*) are added to the URLYour website or integration captures these values
These values are sent in the
metadataobjectMovermate stores them with the lead
Important Notes
gclidis mandatory for Google Ads conversion trackingAlways pass metadata exactly as received (do not modify values)
Ensure proper formatting (no invalid JSON)
Missing metadata may result in loss of campaign tracking
Outcome
By including metadata:
You can track lead sources accurately
Measure campaign performance
Optimize ad spend
Improve reporting inside Movermate
For any inquiries, please reach out to the Movermate Product Experts at [email protected].We're here to help!
β
