Articles on: Integrations

Troubleshooting sync issues

Integrations occasionally stop syncing — OAuth tokens expire, external systems change, network glitches happen. Here's the general playbook.

Step 1 — Check integration status

Settings → Integrations — look for the integration's card. A connected one carries a green check badge and its button reads Delete; a disconnected one has no badge and reads Activate.

If the badge is missing when it shouldn't be, activate the integration again.

Step 2 — Check specific integration pages

HubSpot has a dedicated settings page under Settings → Data → Hubspot: Synced fields, Activities and Tasks.

That page sometimes surfaces specific errors (broken mapping, CRM-side authorization error, etc.) that aren't visible on the integrations list.

For every other integration (Salesforce, Google, Microsoft, Slack, Modjo, Gong, Claap, YouTube, FullEnrich), there's no dedicated page — the card and its Activate / Delete button in Settings → Integrations are the whole surface.

Step 3 — Check permissions on the external side

OAuth tokens can become invalid if:

The user who authorized lost the necessary permissions
The external tool revoked the token (rare, usually due to inactivity)
An admin at the external tool restricted the app

Verify the authorizing user still has access.

Step 4 — Reconnect

The simplest fix for any persistent issue:

Delete the integration
Wait a minute
Activate it again
Re-authenticate

⚠️ For integrations with field mappings (HubSpot), verify mappings after reconnecting — sometimes they need to be re-established.

Step 5 — Integration-specific troubleshooting

For specific integrations, see:

Step 6 — Contact support

If issues persist after reconnecting:

Email contact@katalyz.co with:

Which integration
What's expected vs what's happening
Approximate time issue started
What you've tried

We can check sync logs on our side.

Updated on: 01/10/2026

Was this article helpful?

Thank you!