> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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. Status should show **Connected**.

If it shows **Disconnected**, **Error**, or **Needs re-authentication** — reconnect.

## Step 2 — Check specific integration pages

Only **HubSpot** and **Salesforce** have a dedicated settings page, which appears in the left sidebar of **Settings** once the integration is enabled:

- **Settings → HubSpot** — synced fields, activity toggles, task sync
- **Settings → Salesforce** — same structure (synced fields, activities), with the one difference that there's no "Import from CRM" action

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

For every other integration (Google, Microsoft, Slack, Modjo, Gong, Claap, etc.), there's no dedicated page — status and the **Disconnect** button live in **Settings → Integrations** only.

## 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:

1. **Disconnect** the integration
2. Wait a minute
3. **Connect** again
4. 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:
- [CRM isn't syncing](https://katalyz.crisp.help/en/article/my-crm-isnt-syncing-hubspot-salesforce-16192yz/)
- [An expected meeting isn't showing in the Meeting widget](https://katalyz.crisp.help/en/article/an-expected-meeting-isnt-showing-in-the-meeting-widget-1f74c0k/)
- [Slack notifications are silent](https://katalyz.crisp.help/en/article/slack-notifications-are-silent-y02ddj/)

## 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.

## Related articles
- [Disconnecting an integration](https://katalyz.crisp.help/en/article/disconnecting-an-integration-prb53m/)
- [CRM isn't syncing](https://katalyz.crisp.help/en/article/my-crm-isnt-syncing-hubspot-salesforce-16192yz/)