HubSpot SalesHub & Service Hub

With Zuper’s first-class integration with HubSpot ServiceHub and HubSpot Sales Hub, you can work seamlessly across your sales, services, and support teams to deliver an exceptional customer experience. Using Zuper integration with HubSpot, you can easily create and dispatch field visit jobs, pick the right slot and technician using Assisted Scheduling directly, and access Zuper Job Status updates within HubSpot tickets and deals.

Before you get started

The initial setup is critical for the integration to function smoothly. Once the integration is successfully set up, the Zuper widget will appear in the right-side pane within the HubSpot Deal and Ticket details page.

Please follow the steps below to connect your Zuper Account with your HubSpot ServiceHub and HubSpot Sales account.

A. Integrate Zuper and HubSpot (Setup):

1. Once logged in to your Zuper account, click your Profile Picture in the top right corner of the screen and select “App Store.”

2. You will be redirected to the Zuper App Marketplace, where you must choose the “CRM” category and select “HubSpot.”

3. Click the ” Install HubSpot” button to be redirected to HubSpot.

4. Choose the HubSpot account to which you would like to link the Zuper account.

5. The scope approval access request from HubSpot account screen appears. Check the mark on the terms and conditions and click the “Connect App” button.

8. Now, you can enable “Update HubSpot Settings” by entering the following details.

• Zuper API Key (Mandatory Field): - Enter the Zuper API key
• To create the Zuper API, refer to the below steps:

API Key

If you are trying to integrate Zuper with any external systems, you will need an API key to access the Zuper APIs. To generate API (Application Programming Interface) Key, please follow the below steps.

1. Log in to Zuper with an admin account.
2. Scroll down the menu bar on the left and select the “Settings” icon key.
3. Under the “General Settings” category, select “Account Settings.”

4. On the account settings page, select “API Keys.”

5. Click on “New API Key” and enter the name of the API key in the pop-up windows.

6. Click on “Create” to generate the API key. (Once created, the API key can be viewed by clicking on the “View API Key” hyperlink.)

5. To delete/deactivate an existing API, click on the “Delete API Key” (x) next to the respective API.

Note: The API key generated will provide full permission & access to the user who

created this key. Please ensure to store this key securely.

Note: It is mandatory to enter the Zuper API Key for Integration to perform smoothly.

• Sync Zuper Status Updates (Mandatory Field): - Choose “Yes” to enable the sync of Zuper’s current job status updates with HubSpot.
• Sync Zuper Job Notes (Mandatory Field): - Choose “Yes” to enable the sync of Zuper Job Notes’ current job status updates with HubSpot.
• HubSpot Status Field Name (Mandatory Field): Enter the “Status” field API name of Zuper from where the current status is fetched and reflected in HubSpot.

To get the Status Field Name, Log in to your HubSpot account, and under settings, choose Tickets → Manage ticket Properties → All Properties —> choose Field Visit Status property → Select the “Backslash” link under field type.

You must copy the API label from the “Internal Name” option and paste it under “HubSpot Status Field Name.”

• HubSpot Assignees Field Name: Enter the “Assignees” field API name of Zuper, from which where the current status is fetched and reflected in HubSpot.
• To get the Assignees field name: Login to your HubSpot account, and under settings, choose Tickets → Manage ticket Properties → All Properties → choose Assigned Technician property → Select the “Backslash” link under field type.

• You must copy the API label from the “Internal Name” option and paste it under “HubSpot Assignees Field Name.”

• HubSpot Completed Date Field Name - Enter the internal name of the completed date field in HubSpot to which the Zuper status-completed or closed date will be synced.
• HubSpot Customer Feedback Field Name - Enter the internal name of the customer feedback field in HubSpot, to which the Customer Signature will be synced from Zuper.
• Sync HubSpot Job Notes (Mandatory Field) - Choose “Yes” to enable the sync of HubSpot Job Notes updates with Zuper.
• HubSpot to Custom Fields Mapping - Enter the custom fields API field name of HubSpot followed by Zuper’s custom API field name separated by commas, from which the current status is fetched and reflected from Zuper.

• Once you have filled in all the information, click the “Update” button. Your preference will be updated successfully.

These are the prerequisites for HubSpot and Zuper integration. Once the above setup is ready, a custom workflow action is configured in HubSpot to ensure smooth data flow between the apps.

Add Job widget to HubSpot views

HubSpot has introduced App Cards — a newer, more reliable way for external apps to display data inside HubSpot records. Zuper now supports an App Cards-based Jobs widget that replaces the older CRM Cards-based widget.

App Cards load faster, receive direct support from HubSpot, and are less prone to performance issues. The older CRM Cards have been deprecated by HubSpot and will receive limited support going forward. Zuper recommends that all new customers use the App Cards widget and that existing customers plan a transition at a time that works for them.

Notes: This migration applies only to Deals, Tickets, Contacts, and Company records.

It does not apply to the deal-to-project flow. Zuper does not yet have an App Card for projects.

How to migrate to App Cards

This is a one-time process. You repeat it for each record type that syncs with Zuper: Deals, Tickets, Contacts, and Companies.

 Edit the layout

1.     In HubSpot, go to the record type you want to update.

2.    Select Customize record or Edit layout from the record view.

3.    The layout editor opens with a right-side pane.

Add Zuper Jobs App Card

1.     In the right-side pane, select Add Cards.

2. Select Card Library.
3. In the search field, enter Zuper.
4. Under Apps, locate the Zuper Jobs Card
5. Select the card to add to the layout.

Save and exit

1. Close the sidebar modal.
2. Select Save and exit to apply the updated layout.

Repeat for all synced record types

Repeat Steps 1–3 for each of the following record types:

• Deals
• Tickets
• Contacts
• Companies

Note: Once you complete this process for all four record types, the new App Cards widget is active.

Jobs created with the old CRM Cards widget will also appear in the new widget — no data is lost during the transition.

What to know before you migrate

Your existing jobs are safe

Jobs created through the old CRM Cards widget remain visible in the new App Cards widget. Removing the old CRM card from a record layout does not delete or hide any jobs.

User-specific layouts in HubSpot

HubSpot supports user-specific record layouts. If your team uses personalized layouts, each relevant layout must be updated individually to include the new App Cards widget. Check with your HubSpot administrator to confirm whether user-specific layouts are in use.

The create and view experience stays the same

The process for creating a job and viewing job details inside HubSpot remains unchanged. Only the underlying widget technology is different.

Projects are not affected

The App Cards migration does not apply to the deal-to-project flow. Zuper does not yet have an App Card for projects. Continue to use the existing widget for project-related records.

Removing the old CRM Cards widget

After you add the new App Cards widget, you can remove the old CRM Cards widget from your record layouts. This step is optional.

Existing customers — Removing the old CRM card does not affect your data or the display of jobs in the new App Cards widget. Remove it at a time that suits your team.

New customers — Zuper recommends adding only the new App Cards widget. Remove the old CRM card from all record layouts as part of your initial setup.

 

B. Create Zuper Jobs within HubSpot

You can create jobs in Zuper through the widget in HubSpot’s right-hand panel of the Deal or Ticket Object.

The HubSpot Deal & Ticket sidebar will display the Zuper Jobs widget which will list the associated Zuper’s jobs. Zuper lets you have one or multiple jobs for a single deal or ticket.

To create a new job, Click the “Create Job” button.

The above dialog box opens. Fill in the relevant job details, including all mandatory fields such as Job Category, Scheduled Date, Due Date, etc.

When you try to create a new job from the Zuper widget in HubSpot, some fields, such as Job Title, priority, and Service Address, will be prefilled in the form. The contacts associated with the Deal or Ticket will get pushed. This allows you to create the job quickly.

Zuper Fields	HubSpot’s Equivalent Fields for Zuper
Customer	Contacts
Organization	Company
Assets	Same (Display as per Zuper master)
Parts	Same (Display as per Zuper master)

The customer doesn’t need to be present in Zuper while creating a new Job in Zuper, and the customer fetch from the system happens with the email ID match.

The service address is the customer’s (Contact), and the billing address is the Organization’s (Company ).

1. While creating a job from the HubSpot widget, an existing Zuper customer can be chosen from HubSpot, or a new customer can be created ad hoc in the widget and linked to Zuper.
2. To associate an existing customer, you can choose them from a dialog box based on the available list by searching for their name in the widget’s search bar.
3. To add and associate a new customer with this job, click the “New Customer” option in the widget and provide the necessary details to create a customer. The customer will be associated with the job.

Notes for Job Creation

• A Customer (Contact) or an Organization (Company) is mandatory when creating a new Job.
• The HubSpot widget allows you to create recurring jobs with the following recurrence schedules: .
• Assets, parts, and services related to the job can be picked for the service.
• If custom fields are present in a Job based on the Job category, they will be available to fill in HubSpot. All custom field types are supported except lookup and File Upload.
• Notes added to HubSpot Deal/Ticket will sync to Zuper Job as soon as they are created.
• Attachments were added to the HubSpot Deal/Ticket. Also, create a note in HubSpot, which will be synced to the Zuper Job.
• Notes added to Zuper job will sync directly to the associated Hubspot Deal/Ticket’s notes instead of to a section on the widget.

Whenever the field technician marks the status as ” On my way ” on Zuper, the HubSpot Agent can track their location and ETA through the ” Track Technician ” option under the job’s actions in the widget.

HubSpot App Cards

The new Job Gallery feature brings all your job-related media into one seamless, unified view on Zuper.

For Staff using HubSpot to create jobs, the Gallery feature in HubSpot’s Details page brings all your job-related photos and videos into a single view within HubSpot - no more digging through Checklists, Notes, or Attachments! This provides crucial context and information that agents may need to respond to customers or take action on the Deal/Ticket.

How do you set up the Gallery Feature in HubSpot Deal?

1. Under the “Deals” page, click the “Customize Card” to add the gallery.

2. Select the view you regularly use in the record (deal/ticket) you wish to enable for App Card.

3. Click “+” to add the new tab. (applicable only for enterprise plans).

4. A dialog box will appear. Enter the tab name. Click the “Done” button.

5. Click the “Add Cards” button.

6. An “Add middle column cards” side panel appears. Under “Apps,” check the “Zuper Gallery” check box.

7. Click the “Save and Exit” button to save the card.

8. The App gallery is loaded successfully.

9. Click the “Overview” tab to view the app gallery for CRM Tickets. Click the “Edit Layout” to modify the gallery view.

10. Click any one of the images from the “Job Gallery.” Click the “View Image” button to see the gallery picture. Click the “View Video” button to see the video.

With powerful filtering and grouping, viewing your media has never been easier in the App gallery view. You can view all the media associated with jobs created from the Deal/Ticket in a single place.

Note: Once you “Uninstall” Zuper from HubSpot, the previous data synced between HubSpot and Zuper is retained in Zuper, and the ongoing data sync is disconnected between Zuper and HubSpot.

The business can easily ensure the deal’s conversion to a successful job. In addition, with the bidirectional data flow, job details get updated on both apps (HubSpot CRM and Zuper).

HubSpot Zuper Workflow Automation

With the HubSpot – Zuper Integration, you can currently create a job in Zuper from HubSpot using the Zuper widget on the right-side pane. This provides flexibility in creating a job to suit your different needs. You can specify the job details in the form and create a job. But this will involve some manual effort.

HubSpot Workflow Automation allows you to set up the automatic creation of jobs from deals and tickets from HubSpot to Zuper. You will have greater control over when data from HubSpot is pushed using triggers and how the data is pushed to Zuper with the mapping table. You can push a deal or a ticket to a job and sync customers’ and organizations’ data.

Pre-requisites

• It would be best if you were in the HubSpot Professional or Enterprise plans.
• Ensure HubSpot Zuper Integration is set up (Use this link to set up).

How to install and use Zuper - HubSpot integration

Install HubSpot

1. Log in to your “HubSpot” account and go to the app marketplace.
2. From the app marketplace, navigate to Customer Service, then Field Service Management, and select “Zuper.”

Data Flow

With workflow automation, we can define how data flows between Hubspot and Zuper. Currently, Data flows from the following Hubspot to Zuper modules are supported:

HubSpot Zuper

HubSpot’s Equivalent Fields for Zuper	Zuper Fields
Deal	Job
Ticket	Job
Deal	Project
Contact	Customer
Company	Organization

Module-level data flow is predefined and cannot be changed, i.e., data from deals will always flow into Job and vice versa.

The fields are mapped within each module, which you can control in the mapping table, as explained in the following section. Flows can be unidirectional or bidirectional.

Field Pairing

In the integration between Zuper and HubSpot, field pairing is used to specify how the fields in Hubspot are connected to those in Zuper. This process guarantees that data is accurately moved and interpreted between the two systems.

1. Map the “Deal to Job” fields. HubSpot’s fields get synced with Zuper field. a. The Deals field in HubSpot will be synced with the Job fields in Zuper. b. The Contacts field in HubSpot will sync with the Customer fields in Zuper Company fields in HubSpot get synced with Organization fields in Zuper.

You can use any of the arrows to define how the sync should happen.

i) A single forward and backward arrow represents one-way sync.

ii) Two parallel arrows represent two-way sync.

Note: Click the “Add Field” button to add the additional fields for mapping.

Note: The default value column lets you define the default value to be used if it is empty in Zuper or HubSpot.

2. Map the “Ticket to Job” fields. HubSpot’s fields get synced with the Zuper field. Click the “Save Changes” button to save and configure the workflow.

2. Map the “Deal to Project” fields. HubSpot’s fields get synced with the Zuper field. Click the “Save Changes” button to save and configure the workflow.

2. Map the “Contact to Customer” fields. HubSpot’s fields get synced with the Zuper field. Click the “Save Changes” button to save and configure the workflow. Here, the Zuper Field – “Customer Link” is available by default and can be mapped to any field in the HubSpot Contact record where you wish to populate the URL of the connected Zuper Customer.

5. Map the “Company to Organization” fields. HubSpot’s fields get synced with the Zuper field. Click the “Save Changes” button to save and configure the workflow. Org Link is available to be mapped to a HubSpot field in the Company record. This will push the URL of the connected Zuper Organization to that field.

Note: The sync type in the field mapping must always be set to bi-directional when mapping the Customer/Organization Link to any field in HubSpot.

Within a deal-to-job, ticket-to-job, or deal-to-project flow, we can specify the mapping for the customer or organization that gets synced with the transaction record. This mapping /may differ from the mapping for imcustomer or organization master records, which are available separately.  

To successfully push a Deal/Ticket from HubSpot to Zuper as a Job/Project, data must flow into Zuper from HubSpot. Therefore, the mandatory fields for creating a job/project in Zuper must have forward or bidirectional mapping. Only having reverse mapping from Zuper to HubSpot will not successfully push a deal/ticket to Zuper.  

Field Pairing should be specified for all modules that need syncing between Hubspot and Zuper. Each HubSpot field can be mapped to one Zuper field.

Setup automated workflow

After field mapping is done, you can set up the workflow to act in an automated process. Trigger workflow in HubSpot, and you can see the action in Zuper.

1. Go to Settings -> Automation and click the “+New Workflow.” Select Deal-based or Ticket-based workflow.

2. The initial step is enrollment.

3. You can set up the conditions for the trigger to happen.

4. The event is successfully selected.

5. Here, the relevant Zuper action will be available and can be set.

6. The deal from HubSpot will be pushed as a Job in Zuper. Click the “Review and publish” button.

7. You can review the configurations set and turn on the workflow.

Note: Once the workflow is set up, a new Deal or Ticket that satisfies the corresponding job will be created on Zuper with the specified field mapping. When a field value is updated in Zuper, it will correspondingly update in HubSpot when the direction of sync is Zuper to HubSpot and vice versa.

The fields set to sync bidirectionally will update their values whenever the update happens on either system.

• The automation has now been set up and is live. Once a Deal or Ticket meets the configured trigger criteria, the object data will be pushed to a Zuper job according to the field mapping specified. The fields will also be kept in sync according to the sync direction specified.
• Relevant workflows need to be set up for data flow between other modules. For example, a ticket-based workflow with the relevant Zuper action needs to be set up for data to flow between Ticket and Job.

Important Points:

• It is recommended that only one workflow be set up for each Zuper module sync. For example, only one deal-based workflow using a Zuper action should be created when moving data from a deal to a job.
• For Certain Fields, e.g., calculated fields, the sync direction can only be unidirectional; here, the source field is HubSpot.
• When transferring a large number of deals or tickets from HubSpot to Zuper, expect a 30-minute delay for all records to fully sync. Please wait until the sync is complete before proceeding.
• By default, HubSpot enrolls a record in a workflow only once. To make it trigger every time “Push to Zuper” is set to Yes, enable re-enrollment: open the workflow → Enrollment trigger → Re-enrollment tab → select “Push to Zuper = Yes.”
• Avoid changing “Push to Zuper” and the pipeline stage at the same time. HubSpot may miss the trigger if both fields are saved together. Instead, use “Push to Zuper = Yes” as the enrollment trigger and add the pipeline stage as a filter condition inside the workflow.
• If a job wasn’t created, check Settings → Sync Activity in Zuper before reaching out to support.

Deactivate / Uninstall HubSpot

1. Once logged in to your Zuper account, click your Profile Picture in the top right corner of the screen and select “App Store.”

2. Under “Browse by Category,” select the “CRM” option and choose “HubSpot.” Click “Configure Settings.”

3. Deactivate (pause) the integration (recommended before uninstalling)

On the HubSpot configuration page, click Deactivate.

4. In the confirmation dialog (Deactivate App), click Deactivate again to confirm.

What happens when the HubSpot App is Inactive?

1. Your Configuration Is Retained
Your existing HubSpot configuration — including API key, field mappings, and sync preferences — remains saved. You don’t need to reconfigure anything when you reactivate the app.

2. Data Sync from Zuper Is Paused
Any sync configured from Zuper to HubSpot will stop while the app is inactive.

For example:

• Automatic creation or updates of records in HubSpot based on your sync settings (such as “Push Zuper Job as HubSpot Deal”) will not occur.

3. Data Flow from HubSpot Continues
Actions initiated from HubSpot will still work:

• Job creation from the HubSpot widget will continue to function.
• Jobs, customers, projects, and other records can still be created in Zuper through HubSpot Workflows, if triggered.

4. Impact on Zuper Connect

• Call and SMS activities from Zuper Connect will not be pushed to HubSpot.
• However, the Zuper Connect Dialer within HubSpot will remain active and fully operational.

Uninstall the HubSpot app

Once the app is inactive, click Uninstall App (the red link below the Activate button).

In the confirmation dialog, review the warning and click Uninstall App again to confirm.

HubSpot Sync History

Customers who use the HubSpot integration to create jobs from Zuper to HubSpot sometimes encounter errors. The Sync history feature allows you to troubleshoot these issues.

To help troubleshoot Zuper-HubSpot sync issues, Zuper provides a sync history log of the Jobs and Projects module that tracks data transfers between the two systems Jobs and Projects. This allows you to determine the root cause of errors, resolve them, and resync for smooth integration. 

Sync History

1. Select the “Settings” module from the left navigation menu. Under the “Other Settings,” select the “Sync Activity.”

2. The “Sync History” list page appears.

2.1. Sync UID - The unique ID identifying the sync between Zuper and HubSpot

2.2. Module Name - The module’s name where the sync happened.

2.3. Record ID/Name - The exact module record ID or Name with the hyperlink.

2.4. Application Name - The name of the integrated application.

2.5. Type of Sync—The sync type of the integration can be actions such as Create, Update, and Delete.

2.6. Status - The sync status is shown - Started, Success, or Error status is displayed.

Click a record ID/name to view details. The current sync status of the HubSpot integration and the destination record ID are displayed.

3. The sync will happen and be completed in a few seconds. The sync has been successfully completed. To acknowledge and dismiss the error, click the “Acknowledge” button.

We developed the HubSpot Sync History feature to give our customers clear visibility into their integration processes. By tracking sync activities and highlighting any errors, this tool helps you quickly identify issues

Troubleshooting

Use this section when something does not work as expected in your Zuper–HubSpot integration. Each subsection covers a specific area where issues commonly occur.

Sync history errors

The Sync History log is your first stop when data does not move correctly between Zuper and HubSpot. It records every sync attempt — successful or failed — so you can find and fix problems quickly.

Navigation: Settings → App Store → HubSpot → Sync History

How to read sync history

1. Go to Settings and select App Store.
2. Select HubSpot from the list of installed integrations.
3. Select the Sync History tab.
4. Review the list of sync events. Each row shows:
   • Date and time of the sync attempt
   • Record type — for example, Job, Contact, or Note
   • Direction — Zuper to HubSpot, or HubSpot to Zuper
   • Status — Success or Failed
   • Error message (visible for failed records)
5. Select a failed row to expand it and view the full error detail.

Sync History retains records for the last 30 days. If you need older records, export the data before they expire.

Common sync errors and fixes

Error: “Invalid API key”

The Zuper API key entered during setup has expired or was deleted.

1. Go to Settings → Account Settings → API Keys.
2. Generate a new API key.
3. Go to Settings → App Store → HubSpot → Update HubSpot Settings.
4. Enter the new key in the Zuper API Key field.
5. Select Update.

Error: “Contact not found”

The contact in HubSpot does not have an email address that matches any customer in Zuper.

1. Open the HubSpot contact record.
2. Confirm that an email address is present.
3. Open the matching customer record in Zuper.
4. Confirm that the same email address is entered.
5. Trigger a new sync by updating the job status in Zuper.

Error: “Field mapping failed”

A custom field name in HubSpot does not match what is entered in the HubSpot to Custom Fields Mapping setting in Zuper.

1. Log in to HubSpot and go to Settings → Tickets → Manage Ticket Properties.
2. Locate the property with the error.
3. Select the property and copy the value from the Internal Name field.
4. In Zuper, go to Settings → App Store → HubSpot → Update HubSpot Settings.
5. Paste the correct internal name into the HubSpot to Custom Fields Mapping field.
6. Select Update.

Field names are case-sensitive. “fieldVisitStatus” and “fieldvisitstatus” are treated as different values. Always copy the internal name directly from HubSpot to avoid mismatches.

Error: “Sync disabled”

The Sync Zuper Status Updates or Sync Zuper Job Notes toggle is set to No in your integration settings.

1. Go to Settings → App Store → HubSpot → Update HubSpot Settings.
2. Set Sync Zuper Status Updates to Yes.
3. Set Sync Zuper Job Notes to Yes if you also want notes to sync.
4. Select Update.

If the issue continues, contact Support.

HubSpot action logs vs. the notification panel

Zuper and HubSpot each provide a way to track activity. Understanding the difference helps you know where to look when something goes wrong.

	HubSpot action logs	Zuper notification panel
What it shows	Actions triggered by HubSpot workflows — for example, “Create Zuper Job” or “Update Job Status”	Real-time alerts about job updates, status changes, and sync events inside Zuper
Where to find it	HubSpot → Automation → Workflows → select a workflow → History tab	Zuper → bell icon (top right of any page)
Best used for	Diagnosing why a HubSpot workflow did not fire or sent incorrect data to Zuper	Checking whether a Zuper event — such as a status change — was received and processed
Level of detail	Shows each enrolled record, the action taken, and success or error status	Shows a summary notification per event — no step-by-step breakdown

When to use HubSpot action logs

Use HubSpot action logs when:

• A job was not created in Zuper after a HubSpot ticket or deal was updated
• A workflow action ran but sent incorrect field values to Zuper
• You need to check whether a specific contact or deal was enrolled in a workflow

To access HubSpot action logs:

1. Log in to HubSpot.
2. Go to Automation → Workflows.
3. Select the workflow you want to review.
4. Select the History tab.
5. Filter by Status — select Failed to focus on errors.
6. Select a record row to view the step-by-step action log and error details.

When to use the Zuper notification panel

Use the Zuper notification panel when:

• You want to confirm that a job status update was sent from Zuper to HubSpot
• You are checking whether a note or attachment sync was triggered
• You need a quick summary of recent activity without going into the Sync History log

To access the Zuper notification panel:

1. Log in to Zuper.
2. Select the bell icon in the top-right corner of any page.
3. Review the list of recent notifications.
4. Select a notification to go directly to the related job or record.

The notification panel shows activity for the logged-in user only. To investigate activity for another team member, ask them to check their own panel. For a full cross-user view, use the Sync History log instead.

If the issue continues, contact Support.

App Cards configuration for job display

HubSpot App Cards let you view Zuper job details — including the Job Gallery — directly inside a HubSpot Deal or Ticket. If jobs are not displaying correctly in the App Card, use the steps below to diagnose and fix the issue.

Jobs do not appear in the Zuper widget

Symptom: The Zuper widget is visible in the HubSpot sidebar, but no jobs are listed.

Possible causes and fixes:

• The integration is inactive. Go to Settings → App Store → HubSpot in Zuper and confirm the integration status shows Active.
• No jobs are linked to this Deal or Ticket. Select Create Job in the Zuper widget to create the first job for this record.
• The contact email does not match. Zuper matches contacts by email address. Confirm the email on the HubSpot contact record matches the customer email in Zuper.

The Job Gallery card is missing from the Deal or Ticket page

Symptom: The Zuper Job Gallery App Card does not appear on the HubSpot Deal or Ticket details page.

Fix:

1. Open the HubSpot Deals or Tickets page.
2. Select Customize Cards (found in the page header or layout settings).
3. Select the view you use for that record type.
4. Select Add Cards.
5. In the Add middle column cards panel, go to Apps and select the Zuper Gallery checkbox.
6. Select Save and Exit.

The + button to add a new tab is only available on HubSpot Enterprise plans. On other plans, add the Zuper Gallery card to an existing tab.

The Job Gallery loads but shows no images or videos

Symptom: The Zuper Gallery card appears in HubSpot, but it is empty even though photos or videos exist on the job in Zuper.

Possible causes and fixes:

• Media was not attached to the job in Zuper. Open the job in Zuper and confirm that photos or videos are present in the Checklists, Notes, or Attachments sections.
• The job is not linked to the HubSpot Deal or Ticket. In the Zuper widget inside HubSpot, confirm the job appears in the job list. If it does not, create a new job or link the existing job to the Deal or Ticket.
• The App Card layout was not saved correctly. Repeat the steps under “The Job Gallery card is missing” above to re-add and save the card.

Job status updates are not showing in HubSpot after the job changes in Zuper

Symptom: The job status changes in Zuper — for example, from Scheduled to In Progress — but the HubSpot ticket or deal property does not update.

1. Confirm that Sync Zuper Status Updates is set to Yes in your integration settings (see Sync history errors above).
2. Confirm that the HubSpot Status Field Name in your integration settings matches the Internal Name of the status property in HubSpot.
3. Check the Sync History log for any failed events related to this job.
4. If the field name is incorrect, update it and select Update to save.

If the issue continues, contact Support.

---

FAQs

1. How long does it take for a Zuper job update to appear in HubSpot?
   Updates sync in near real time — typically within a few seconds of the change in Zuper. If an update does not appear after a few minutes, check the Sync History log for errors.
2. Can I sync custom fields from HubSpot to Zuper?
   Yes. Enter the HubSpot internal field name and the corresponding Zuper custom field name in the HubSpot to Custom Fields Mapping setting, separated by a comma. Both fields must exist before you set up the mapping.
3. Why does my HubSpot workflow say the “Create Zuper Job” action failed?
   This usually means a mandatory field — such as Job Category or Scheduled Date — was not included in the workflow action. Open the workflow in HubSpot, review the History tab for the failed record, and check which field caused the error. Update the workflow action to include all required fields.
4. What happens to my synced data if I uninstall the HubSpot integration?
   All data already synced between Zuper and HubSpot is retained in both systems. New changes made after uninstalling will no longer sync. You can reinstall the integration at any time to resume syncing.
5. The Zuper widget shows a job, but the HubSpot Deal status has not changed. What should I check?
   Start with three checks. First, confirm Sync Zuper Status Updates is set to Yes in your integration settings. Second, confirm the HubSpot Status Field Name matches the property internal name in HubSpot. Third, review the Sync History log for a failed event tied to that job.
   If the issue continues, contact Support.