HubSpot Integration Errors and Resolution in BoldDesk
Updated:
This article helps you troubleshoot common HubSpot integration errors in BoldDesk. These errors can occur when creating or linking HubSpot contacts, companies, and deals, validating required field values, or synchronizing records between BoldDesk and HubSpot. Use this reference to identify validation issues, record-linking problems, and integration processing failures, and follow the recommended steps to successfully complete HubSpot operations.
HubSpot Error Messages and Resolutions
| Error message | When it displays | How to resolve |
|---|---|---|
| Invalid email ID | A HubSpot contact creation request contains an email value that HubSpot treats as invalid or malformed. | Verify the email format (for example, [email protected]). Remove leading/trailing spaces and ensure the value is a single email address. Then retry the contact creation. |
| Company name required. | A HubSpot company operation is submitted without the required company name field. | Add the company name field to the request payload and retry the operation. |
| Contact Group name required. | A HubSpot contact group operation is submitted without the required contact group name field. | Add the contact group name field to the request payload and retry. |
| Deal name required. | A HubSpot deal operation is submitted without the required deal name field. | Add the deal name field to the request payload and retry. |
| Deal stage required. | A HubSpot deal operation is submitted without the required deal stage field. | Add the deal stage field to the request payload and retry. Ensure the deal stage value matches a valid stage in the target pipeline. |
| Deal value has to be within the range of -99999999999999999999 to +99999999999999999999 | A HubSpot deal operation submits a deal value outside the supported numeric range. | Reduce the submitted deal value to be within the allowed range, then retry. |
| Domain required. | A HubSpot company operation is submitted without the required domain field. | Add the domain field to the request payload (for example, example.com) and retry. |
| Email required. | A HubSpot contact operation is submitted without the required email field. | Add the email field to the request payload and retry. |
| Invalid close date | A HubSpot deal operation submits a close date value that HubSpot treats as invalid or malformed. | Verify the close date format used by the integration. Correct the value (including timezone/locale formatting if applicable) and retry. |
| Invalid domain name. | A HubSpot company operation submits a domain value that HubSpot treats as invalid or malformed. | Use a valid domain (for example, example.com). Remove protocols (https://) and paths (/page). Then retry. |
| (fieldName) can be maximum 255 characters long. | A submitted field value exceeds HubSpot’s maximum length of 255 characters for that field. | Shorten the value to 255 characters or fewer and retry. |
| Pipeline name required. | A HubSpot deal creation request is submitted without the required pipeline name. | Provide the pipeline name in the request and retry. Ensure the pipeline exists in the target HubSpot account. |
| Company doesn’t exist in HubSpot. | BoldDesk attempts to link a BoldDesk company to a HubSpot company record, but the HubSpot company ID is not found (deleted, incorrect, or never valid). | In HubSpot, go to Contacts → Companies, search by company name, open the company, and copy the company ID from the URL. Update the linked HubSpot company ID in BoldDesk. If the company was deleted, recreate it in HubSpot and link again. |
| Contact already exists in HubSpot. | BoldDesk attempts to create a new HubSpot contact, but HubSpot already has a contact with the same email address. | In HubSpot, search for the existing contact by email, then link that existing HubSpot contact to the BoldDesk record instead of creating a new one. If a separate record is required, change the email to a unique value before creation. |
| Contact doesn’t exist in HubSpot. | BoldDesk attempts to link to a HubSpot contact ID that HubSpot cannot find (deleted or incorrect ID). | In HubSpot, go to Contacts, locate the person by email/name, open the record, and copy the contact ID from the URL. Update the linked contact ID in BoldDesk. If deleted, recreate the contact in HubSpot and relink. |
| An error occurred when processing HubSpot integration. | A general integration processing failure occurs while handling a HubSpot event. | Check the HubSpot integration logs in BoldDesk for the failing operation, correct any underlying data/configuration issue, and retry. If it persists, verify the HubSpot integration configuration and re-run the failed action. |
