Troubleshooting HubSpot error messages in your Koalify workflow actions

Most of these error messages come directly from HubSpot. We surface them in your Koalify workflow action  so you can quickly see what’s happening and take action. In most cases, errors resolve automatically or by upgrading to a paid account. Below, we’ll show you how to review your error logs and address the most common issues.

1. Check the Action Logs of your Workflow

• In your HubSpot account, go to Automations > Workflows
• Open the workflow that includes the Koalify action
• Open the Actions logs of the workflow 
• Fitler the Events to only show the Errors

2. Common Error Messages

Information	What the information means	What action is required
Action failed because of the free trial limit of 100 merges.	You have exceeded the free trial limit of 100 duplicate merges in Koalify.	To continue merging duplicates, upgrade to a paid Koalify account.
Action failed because HubSpot is being rate limited by the connected app, but will retry soon.	A limit was reached while transferring data between HubSpot and the connected app. The action will try again.	No action is required. The process will retry automatically and complete successfully.
There was a problem completing this action. We didn't get a response from the connected app.	There was a timeout in the requested action from the connected app. The action will try again.	No action is required. The process will retry automatically and complete successfully.

3. Records Stuck in a Workflow Action

If you reach the free trial limit (100 merges), new records may get stuck in the workflow. Once you upgrade to a paid plan, you’ll be able to start merging again:

1. Turn the workflow off: this will unenroll stuck records
2. Turn the workflow back on: make sure re-enrollment is enabled

Your records will re-enroll and continue merging without interruption.