TL;DR: Solutions to the most common issues with HubSpot Integration Plus — records not syncing, paused syncs, permissions errors, and more. If nothing here helps, contact us at hello@fantasymedia.io.
My record wasn't created
When syncing from HubSpot to monday.com, certain required fields must have values. If a required HubSpot property is empty, the item may not be created.
Required fields vary by object: Deal Name (Deals), Email or First Name + Last Name (Contacts), Company Name or Domain (Companies), Ticket Name (Tickets).
Troubleshooting:
Check your field mapping — make sure the correct columns are mapped to the required fields. See Field Mapping.
Verify the mapped property has a value — if a required HubSpot property is empty, the item won't be created.
Check column type compatibility — you can't map a Status column to a text-only property. The column type must match what the field expects.
Record existed before the sync — existing HubSpot records and monday items sync after their next update. Make a change to the record or item to trigger it.
Changes aren't syncing back to HubSpot
If you update an item in monday.com but the change doesn't appear in HubSpot:
Check the sync direction — the field may be set to HubSpot → monday.com only. Open field mapping and check the direction arrows.
Check if the property is read-only — some HubSpot properties (Record ID, Create Date) can't be written to from external apps.
Check your outgoing conditional triggers — the item may not match your outgoing filter criteria.
My sync stopped working
If your sync was working and suddenly stopped, it's usually one of these:
Quota reached — syncs pause automatically when you hit 100% of your monthly actions. You'll receive email notifications at 50%, 75%, and 100%. Upgrade your plan or wait for your quota to reset on the 1st of the month. See Plans, Billing & Usage.
HubSpot token expired — your connection to HubSpot may have expired. You'll need to re-authenticate. See Re-authenticate with HubSpot.
HubSpot account disconnected — if someone disconnected the HubSpot account (from the app or from HubSpot's side), the sync will stop. Reconnect it in the HubSpot 2-way Sync view on your board. See Re-authenticate with HubSpot.
HubSpot Link column issues
The HubSpot Link column stores the link between your monday.com items and HubSpot records. If it's deleted or broken, syncs can't create or update records.
Column deleted — undo right away, or restore the column from your monday.com Trash. Don't rebuild the sync first.
Values manually edited — the sync engine may lose track of which HubSpot record each item connects to, causing duplicates or failed updates.
Permissions issues
If you see the error "Sorry, something went wrong, please try again or contact the developer", it's usually a permissions issue at one of three levels: Account, Workspace, or Board.
Account level — the user's role must be allowed to create automations/integrations and webhooks (Admin → Permissions)
Workspace level — same permissions must be enabled for the user's workspace role
Board level — the board must allow the user to edit and create automations (Board menu → Permissions)
HubSpot side — the connected HubSpot user must have access to the CRM objects being synced
If all permissions are in place and you're still seeing the error, contact us at hello@fantasymedia.io.
Duplicate items appearing
If the same HubSpot record is creating multiple items on your board:
Check the HubSpot Link column — if it was deleted or cleared, the app can't detect existing connections and creates new items
Check for multiple syncs — each person can have one sync per board, but different users can each set up their own. If two syncs on the same board point to the same HubSpot object, each will create its own item
Common gotchas
Sync issues are almost always caused by one of: missing field values, expired HubSpot tokens, or permissions. Start with those three.
The app sends email notifications when your quota reaches 50%, 75%, and 100% — check your inbox (or spam folder) if you suspect a quota issue.
When in doubt, check that your portal shows Active under Connected HubSpot Accounts in the HubSpot 2-way Sync view on your board. If it doesn't, connect it again. See Re-authenticate with HubSpot.