Webhooks in HeavySet Tech: Setup, Payloads, and Extra Fields

Webhooks are a great feature that allow your system to send real-time data to another application or service. This quick communication will allow your team to stay up-to-date with new leads and appointments. There are several spots in your HeavySet Tech app where you can enable and configure webhooks, and we'll go over one of those spots here. 

To enable webhooks, navigate to the Connections menu, open the CRM expander, and click the Edit Config menu item. 

---

How to Enable Webhooks

1. Navigate to Connections in the left-hand menu.

2. Expand CRM.

3. Click Edit Config.

4. Under Email Settings, click Enable Webhooks or Notify Emails.

---

Adding Webhook URLs

In the configuration modal:

• Enter one or more Webhook URLs (the endpoint(s) where HeavySet Tech will send data).

• Multiple URLs may be added by separating them with commas.

• Each URL will receive the same webhook payload.

• URLs must be fully qualified (for example: https://www.example.com/webhook).

You may also add email addresses to receive notifications when new leads are created and choose how frequently those emails are sent. Email notifications can be enabled whether or not webhooks are turned on.

---

Webhook Payload: Lead Fields

When a webhook is triggered for a new lead, the following fields may be included in the POST payload:

• firstName – First name of the lead

• lastName – Last name of the lead

• name – Full name of the lead

• address1 – Primary address

• address2 – Secondary address

• city – City

• state – State or province

• stateAlpha2 – Two-letter state/province code (e.g., CA, NY)

• zip – Postal or ZIP code

• country – Country name

• countryAlpha2 – Two-letter country code

• countryAlpha3 – Three-letter country code

• phone – Phone number

• email – Email address (optional)

• leadId – Unique lead ID (optional)

• prospectId – Prospect ID (optional)

• createdDate – Date the lead was created (optional)

• source – Lead source (optional)

• sourceType – Lead source type (optional)

• optOutText – Whether the lead opted out of text messages (optional)

• optOutEmail – Whether the lead opted out of emails

• tcpa – TCPA compliance flag (optional)

• marketSegment – Market segment (optional)

• blockId – Block ID (optional)

• optIn – Whether the lead opted in

• product – Product of interest (optional)

• disposition – Lead status or disposition (optional)

• hearAbout – How the lead heard about your company (optional)

• homeYear – Year the home was built (optional)

---

Webhook Payload: Appointment Fields

When a webhook is triggered for an appointment, all lead fields above are included, along with the following appointment-specific fields:

• appointmentStatus – Current appointment status

• start – Appointment start date and time (UTC)

• end – Appointment end date and time (UTC)

• startAMPM – Start time in AM/PM format (optional)

• endAMPM – End time in AM/PM format (optional)

• id – Unique appointment ID (optional)

• created – Date the appointment was created (optional)

• confirmed – Whether the appointment is confirmed (optional)

• salesRepEmail – Sales representative’s email (optional)

• salesRepName – Sales representative’s name (optional)

---

Including Parent URL Parameters (Webhook Extra Fields)

HeavySet Tech can optionally include query parameters from the parent URL (such as a landing page or referring page) directly in webhook payloads.

What Webhook Extra Fields Do

When Webhook Extra Fields is enabled:

• Query parameters from the parent URL are automatically parsed

• Each parameter is added as a top-level field in the webhook payload

• These fields are sent alongside standard lead or appointment data

This is especially useful for passing tracking values, campaign identifiers, or custom metadata to downstream systems.

---

Example

If the parent URL contains the following parameters:

?abc=thisisatest&efg=thisisatest&qrs=thisisatest

Those parameters will appear in the webhook payload as individual fields:

{
  "firstName": "WebhookTest",
  "lastName": "Webhooktest",
  "email": "[e-mail]",
  "phone": "[phone]",
  "leadId": "a0wUQ000007ocpFYAQ",
  "prospectId": "a0ZUQ00000B339V2AR",
  "createdDate": "2026-02-04T23:21:00.000Z",
  "abc": "thisisatest",
  "efg": "thisisatest",
  "qrs": "thisisatest",
  "formName": "Example Lead Form",
  "formStyleName": "Example Form Style"
}

Note: Form names and style names shown above are placeholders and will reflect your actual form configuration.

---

How to Enable Webhook Extra Fields

1. Navigate to Organizations.

2. Click Edit Organization.

3. Enable Webhook Extra Fields.

4. Save your changes.

Once enabled, all future webhook calls will automatically include parent URL parameters when present.

---

Summary

Webhooks are a powerful way to integrate HeavySet Tech with external systems and services in real time. By configuring webhook URLs and optionally enabling Webhook Extra Fields, you can automatically send lead and appointment data to other platforms.