How to Use UTM Tracking in LeadConvertor

UTM tracking ensures that campaign data such as source, medium, campaign name, & advertising identifiers remain attached to a lead throughout their journey, from first interaction to enquiry submission.

How UTM Tracking Works

LeadConvertor automatically captures all URL parameters present on the landing page, excluding any parameters generated internally by Canibuild.

These captured parameters are:

Combined into a single trackingUrl value.
Preserved in key-value format.
Passed through all relevant systems, including:
- Webhooks.
- HubSpot integrations.
- Lead email notifications.
- Lead generation records.

This ensures consistent campaign attribution across all platforms without requiring manual configuration per event.

Use Case Example

If the user has landed from any campaign where the campaign details are present in the URL, we are sending that data on each subsequent webhook, HubSpot, Lead generation data.

This includes:

Enquiry submissions.
Webhook payloads.
CRM records.
Automated lead notification emails.

Webhook Example – Enquire Event

🟦 Event Metadata – what happened & when
🟩 User Info – who performed the action
🟨 Address / Project Info – where the action occurred
🟪 Design / Document Info – what was worked on
🟥 System / Status Info – system identifiers & processing data

Sample Enquire Webhook Payload

{
🟩 "firstname": "John",
🟩 "lastname": "Doe",
🟩 "email": "johndoe@johndoe.com",
🟩 "phone": "9012391230",

🟨 "address": "41854 Calle Californios Lancaster, CA 93536, USA",
🟨 "addressStreet": "41854 Calle Californios",
🟨 "city": "Lancaster",
🟨 "state": "CA",
🟨 "zip": "93536",
🟨 "country": "USA",

🟪 "designName": "Asilo - Modern",

🟦 "message": "adu (Asilo - Modern) at 41854 Calle Californios Lancaster, CA 93536, USA",
🟦 "trackingUrl": "utm_source=abc&utm_medium=cpc&utm_campaign=abc&gad_source=1",
🟦 "lookupLink": "https://app.canibuild.com/lookup/12345",
🟦 "ip": "49.36.180.197",
🟦 "date": "2025-02-06T03:46:29.785Z",

🟥 "zone_id": 600,
🟥 "zone_name": "ABC",
🟥 "idTenant": 1,
🟥 "idLead": 462,
🟥 "idWidgetConfig": 2
}

Lead Notification Email Behaviour

When an enquiry is submitted, an email is automatically sent to the Lead Data Recipient configured in the LeadConvertor widget.

The email includes:

Client contact details.
Design information.
Property address.
The full Tracking URL, preserving all campaign parameters.

Example Email Content

Hello,

You have received a message from the Canibuild widget.

🟩 Name: John Doe
🟩 Email: johndoe@johndoe.com
🟩 Phone: 1234567890

🟦 Message: pool at 11/11 Toward St, Murrumbeena, VIC 3163, Australia
🟨 Address: 11/11 Toward St, Murrumbeena, VIC 3163, Australia
🟪 Design Name: TestDemo

🟦 Tracking URL: utm_source=abc&utm_medium=cpc&utm_campaign=abc
🟦 Lookup Link: https://app.canibuild.com/lookup/12345

HubSpot Integration Behaviour

When HubSpot integration is enabled, UTM parameters are passed through using the tracking_url property on the contact record.

HubSpot Enquire Payload Example

{
🟩 "email": "john.doe@example.com",
🟨 "properties": {
🟩 "firstname": "John",
🟩 "lastname": "Doe",
🟩 "phone": "+1234567890",

🟨 "address": "123 Main St",
🟨 "city": "New York",
🟨 "state": "NY",
🟨 "zip": "10001",
🟨 "country": "USA",

🟦 "tracking_url": "utm_source=google.com"
}
}

This allows marketing teams to accurately report on:

Campaign performance.
Lead source attribution.
Conversion tracking.
CRM automation flows.

Supported Events

The trackingUrl parameter is included across the full range of LeadConvertor events, including:

Enquire submissions.
Address lookups.
Design interactions.
Login events.
Payment events.
CRM & automation workflows.

A complete set of payloads for all supported events is available in the Webhooks Reference Documentation.