---
title: "Integrations"
---
# Integrations

Connect Karolina to your existing tools for comprehensive customer intelligence.

## Overview

Karolina integrates with your CRM, communication, support, and analytics tools to provide a unified view of customer health.

### Integration Types

| Type | Examples | Connection Method |
|------|----------|-------------------|
| OAuth | Slack, Salesforce, Gmail | Secure authorization flow |
| API Key | Stripe, PostHog, Amplitude | Direct API access |
| Webhook | Custom systems | Incoming/outgoing events |

## Supported Integrations

### CRM Platforms

| Integration | Syncs | Setup Guide |
|-------------|-------|-------------|
| [Salesforce](salesforce.md) | Accounts, Contacts, Opportunities | OAuth |
| [HubSpot](hubspot.md) | Companies, Contacts, Deals | OAuth |

### Communication

| Integration | Syncs | Setup Guide |
|-------------|-------|-------------|
| [Slack](slack.md) | Notifications, Channels | OAuth |
| [Gmail](gmail.md) | Emails, Drafts | OAuth |
| [Outlook](outlook.md) | Emails, Calendar | OAuth |
| [Google Calendar](google-calendar.md) | Meetings, Events | OAuth |
| [Intercom](intercom.md) | Conversations | OAuth |

### Support

| Integration | Syncs | Setup Guide |
|-------------|-------|-------------|
| [Zendesk](zendesk.md) | Tickets | OAuth |

### Analytics

| Integration | Syncs | Setup Guide |
|-------------|-------|-------------|
| [PostHog](posthog.md) | Feature usage, Events | API Key |
| [Amplitude](amplitude.md) | Product analytics | API Key |
| [Mixpanel](mixpanel.md) | User behavior | API Key |

### Billing

| Integration | Syncs | Setup Guide |
|-------------|-------|-------------|
| [Stripe](stripe.md) | Subscriptions, MRR, Churn | API Key |

## Connecting an Integration

### OAuth Integrations

1. Go to **Settings** → **Integrations**
2. Find your integration
3. Click **Connect**
4. Authorize Karolina in the provider's portal
5. Configure sync preferences
6. Click **Save**

### API Key Integrations

1. Go to **Settings** → **Integrations**
2. Find your integration
3. Click **Connect**
4. Enter your API credentials:
   - API Key
   - Secret Key (if required)
   - Region/URL (if applicable)
5. Click **Verify & Save**

## Sync Settings

After connecting, configure sync behavior:

### Sync Frequency

| Option | Description |
|--------|-------------|
| Real-time | Immediate updates via webhooks |
| Hourly | Data syncs every hour |
| Daily | Full sync once per day |
| Manual | Only on-demand sync |

### Sync Scope

Select which data to sync:

- All records
- Specific record types
- Records matching filters

## Managing Integrations

### Viewing Integration Status

1. Go to **Settings** → **Integrations**
2. See status indicators:
   - 🟢 Connected: Active and syncing
   - 🟡 Warning: Syncing with issues
   - 🔴 Error: Connection failed
   - ⚪ Disconnected: Not active

### Editing Integration Settings

1. Click the integration card
2. Update credentials or settings
3. Click **Save Changes**

### Disconnecting an Integration

1. Click the integration card
2. Click **Disconnect**
3. Confirm the action

> **Warning**: Disconnecting will stop all data sync. Historical data will be preserved.

## Webhook Configuration

### Incoming Webhooks

Receive events from external systems:

1. Go to **Settings** → **Integrations** → **Webhooks**
2. Click **Add Webhook**
3. Enter the webhook URL in your external system
4. Configure event types to receive
5. Test the connection

### Outgoing Webhooks

Send events to external systems:

1. Go to **Settings** → **Integrations** → **Webhooks**
2. Click **Create Outgoing Webhook**
3. Enter the target URL
4. Configure payload format
5. Set up authentication

## Troubleshooting

| Issue | Solution |
|-------|----------|
| OAuth authorization fails | Check redirect URIs, clear cookies |
| API key invalid | Verify key permissions, regenerate if needed |
| Sync stuck | Check rate limits, try manual sync |
| Data missing | Verify API permissions, check filters |

For detailed troubleshooting, see [Integration Errors](../troubleshooting/integration-errors.md).