Skip to main content
Adding a contact allows you to manage individual client information. This includes essential details such as the contact’s name, phone number, email address, preferred time zone, and association with an organization or property. By creating a contact, you can easily communicate with the right individuals, assign them to jobs or service requests, and maintain a detailed history of all interactions. Follow the steps below to add a new contact and link them with organizations or properties as needed.
Navigation: Clients -> Contacts -> + New Contact
  • Select the “Clients” module from the left navigation menu and choose “Contacts”.
  • The Contacts listing page opens.
  • Click the ”+ New Contact” button at the top right corner of the page.
Contacts1 Pn Fill in the following sub-sections:
  1. Primary Details
    • First Name (Mandatory): Enter the contact’s first name.
    • Last Name: Enter the contact’s last name. This field is optional but helps in full-name identification.
    • Organization: Select the organization the contact is associated with. This links the contact to a business entity.
    • Email (Mandatory): Provide the contact’s official email address. This email will be used for sending job-related notifications, invoices, and other communications.
    • Preferred Timezone: Choose the timezone that applies to the contact. This ensure that all time-sensitive activities, such as job scheduling, and alerts are correctly aligned with their local time.
    • Category: Select a category that best classifies the contact (e.g., decision-maker, technician, billing). Helps in filtering and reporting.
    • Accessible by everyone: Indicates if the contact should be visible to all users. Set to “No” by default to restrict visibility.
    • Account Manager (Mandatory): Choose the internal user responsible for managing this contact. Required to ensure accountability.
    • Tags: Add one or more tags to help categorize and search for the contact easily.
    • Has SLA: Specify whether the contact is covered under a Service Level Agreement (SLA). Select an option from the dropdown.
    • Pricelist: Select the relevant price list to be applied when jobs or services are performed for this organization.
    • Description: Provide a brief description for this contact.
Contacts2 Pn

Lead Source

The Track Lead Source option helps you record the origin of your leads. Enabling this setting ensures every new customer or job record includes a field to capture and report the source of the lead. This feature improves marketing insights, sales performance tracking, and lead attribution. Prerequisites
  • Admin or user role with permission to manage customer and contact settings.
Enable Lead Source Tracking 1.     Navigate to Settings from the main menu. Select Customer/Contact Settings. Lesource1 Pn
  1. Open the General tab. Scroll to Track Lead Source? Toggle the switch ON (Yes) to enable. Click Save in the top-right corner. Lesource3 Pn Once enabled, a Lead Source field appears on the Customer/Contact and Job creation and edit experience. Users can select or enter the lead source when adding or editing records.
Create and Manage Lead Sources After enabling the feature, you can manage your lead sources by following the steps below:
  1. Navigate to Settings → Customer/Contact Settings → Lead Sources.
Lesource2 Pn
  1. The Lead Sources page displays all active sources_._
  2. To add a newsource :
    • Click + New Lead Source in the top-right corner.
    • Enter a descriptive name (e.g., Instagram Campaign, Email Marketing, etc.)
    • Click Save.
Lesource5 Pn
  1. To edit an existing source, under “Actions”, click the pencil (✏️) icon beside it, make your updates, and save. To delete a lead source, click the trash (🗑️) icon and confirm the deletion.
Lesource6 Pn
  • These lead sources will appear as selectable options when users assign a source to a customer /contact or job record.
Lesource7 Pn Using Lead Source Data
  • View the lead source in customer /contact details or Job details.
  • Filter customers/contacts and jobs by lead source in lists by filtering them as “Source”.
  • Use this data to evaluate which channels bring the most leads.
    Note: The first job will inherit the lead source from the customer record. The second job onwards, it should be manually selected.
Reporting and Analytics Reports The Source field has been added as a column in core reports to enhance tracking and analysis:
  • Job Master Report
  • Customer Master Report
  • Report Builder (fully integrated for custom report creation)
Dashboard Widget A new Horizontal Bar Chart Widget has been introduced to visualize Lead Source metrics directly on the dashboard:
  • Lead source: Displays the lead sources.
  • No. of Jobs: Shows the “Total number of Jobs against that particular lead source.”
  • On hover: Reveals the total job value against that particular lead source.
  • Filterable by date range: Users can apply custom date filters to focus on specific periods (e.g., quarterly or yearly trends).
This widget enables you to identify top-performing lead sources and optimize your marketing efforts efficiently. Bulk Operations Lead Source is now available in the Bulk Update feature for efficient data management:
  • Customer Module: Update Lead Sources in bulk for multiple customers at once.
  • Job Module: Apply Lead Source changes across batches of jobs.
This streamlines onboarding and corrections, eliminating the need for manual entry for each record.  Filtering Enhanced filtering options have been added to improve search and navigation:
  • Filter by Source on the Job Listing Page.
  • Filter by Source on the Customer Listing Page.
Dynamic Updates: Results refresh in real-time as users select or multi-select lead sources, ensuring quick and relevant views without page reloads. Configuring Lead Source Sync in HubSpot-Zuper Integration To enable seamless Lead Source tracking across HubSpot and Zuper, follow these steps for setup and mapping: Create Custom Lead Source Fields in HubSpot: Individually add a custom field for “Lead Source” to the Contact and Deal entities in HubSpot. This field will capture the origin of leads. Map Fields in Zuper HubSpot Integration Settings: Once created, navigate to Zuper Settings > Integrations > HubSpot. Map these HubSpot fields to Zuper’s primary Lead Source fields in the Customer/Contact and Jobs modules. Sync Direction and Data Flow: With mapping complete, Lead Source information flows bidirectionally: Depending on the integration direction (HubSpotZuper or Zuper → **HubSpot, **or both ways), updates propagate automatically, ensuring consistency across platforms.

Edge Cases & Validations

In Zuper, the Lead Source feature is designed to be flexible and user-friendly, but it’s essential to understand how it behaves in various edge cases. Below is a summary of common scenarios, their expected behaviors, and any relevant notes. This ensures smooth data management and avoids unexpected issues during implementation.
ScenarioExpected BehaviorNotes
Job created without a lead sourceAllowed – field is optional.Users can proceed without selecting a Lead Source; the job will be created successfully, and the field will remain blank. This supports quick entry for non-critical tracking.
Lead Source removed from master listExisting records retain the old value (now marked as inactive).Removed sources won’t appear in new dropdowns or selections, but historical data is preserved for reporting and auditing. No automatic cleanup or migration occurs.
The customer has no lead source, but the job has the lead sourceAllowed – no backfill required.Lead Sources are independent per record type (Customer vs. Job).
User disables “Track Lead Source”The field is hidden across the entire UI and not populated for new records.This global setting (under Admin > Settings) removes the field from forms, reports, dashboards, and filters. Existing data remains intact but is no longer visible or editable until re-enabled.
Best Practices
  • Define a standard list of lead sources to maintain consistency.
  • Encourage team members to fill in the lead source for every new record.
  • Utilize reports or dashboards to analyze trends in lead sources.
  1. Contact Information
    • Home Number: Enter the contact’s home phone number. Useful for personal or after-hours communication.
    • Mobile Number: Enter the contact’s mobile number. This is typically the primary method of communication.
    • Work Number: Enter the contact’s office or work phone number. Ideal for professional interactions.
  2. Portal Details
    • Portal Access: Specify whether the contact should have access to the customer portal. Set to “Yes” to enable access and allow self-service features like viewing jobs, invoices, and quotes..
  3. Tax Details Choose the applicable tax settings for the contact based on your region or internal policies. These settings will automatically be applied to invoices and billing documents.
    • Tax Preference: Choose whether the contact is Taxable or Tax Exempt. This affects how taxes are calculated for this contact in quotes and invoices.
    • Tax Group: Pick the appropriate tax group that applies to this contact. Tax groups define the specific tax rates or rules used.
  4. Account Details
    • Billing Frequency: Choose how often the contact should be billed (e.g., monthly, quarterly, yearly). Helps automate and manage billing cycles.
    • Payment Term: Select the agreed-upon payment term for the contact. This defines the time frame within which payment is expected.
Contacts3 Pn
  1. Property: You can associate properties with the contact to ensure seamless tracking of service history and work orders. To add a property,
    • Click ”+ Pick Property” next to the Property section.
    • Use the pop-up to search and select the relevant properties that belong to the contact.
  2. Service and Billing Address: Add the contact’s service and billing locations. You can specify these details in two ways.
    • Address Entry: Type the full physical address.
    • Geo-Coordinates: Enter latitude and longitude if you want to use exact map-based positioning.
    For the most accurate location data, use the “Pick from Map” option. This allows you to pinpoint the address directly on the map interface.
    Once you’ve selected the correct location, click “Use this Address” to save the information.
Contacts4 Pn
  1. Other Details If any custom fields are added under the settings, you can fill in the details here.
After entering all the necessary details, click the “Save Contact” button to successfully create the contact. Once saved, the contact will be available across the system and can be linked to jobs, quotes, invoices, and service requests. Contacts5 Pn