> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Connections

> Connect and manage your integrations

The Connections page is where you manage all integrations between Duckie and your external platforms.

## Accessing Connections

Go to **Settings → Connections** in your dashboard.

## Connection Categories

Integrations are organized by purpose:

| Category | Purpose | Integrations |
| - | - | - |
| **Ticketing** | Support requests | Zendesk, Intercom, Plain, Pylon, HubSpot |
| **Messaging** | Real-time chat | Slack, Discord, Teams |
| **Documentation** | Knowledge sources | Notion, Confluence, Google Drive |
| **Issues** | Bug tracking | Jira, Linear, GitHub |

## Connecting an Integration

**1. Find the Integration**

Browse by category or search.

**2. Click Connect**

Click the **Connect** button on the integration card.

**3. Authorize**

Complete the connection flow:

**OAuth integrations:** Redirected to authorize access

**API key integrations:** Enter your credentials

**4. Configure (if needed)**

Some integrations require additional setup:

* Select workspaces or channels
* Configure sync settings
* Set permissions

## Connection Status

Each integration shows its status:

| Status | Meaning | Action |
| - | - | - |
| **Connected** | Active and working | None needed |
| **Not Connected** | Not set up | Click Connect |
| **Needs Reconnection** | Auth expired/failed | Click Reconnect |
| **Error** | Something is wrong | View error, troubleshoot |

## Managing Connected Integrations

### Viewing Details

Click on a connected integration to see:

* Connection status
* Connected account/workspace
* Last sync time (knowledge sources)
* Configuration options

### Reconnecting

If a connection expires or breaks:

**1. Find the Integration**

Look for "Needs Reconnection" status.

**2. Click Reconnect**

Click the **Reconnect** button.

**3. Re-authorize**

Complete the authorization flow again.

### Disconnecting

To remove an integration:

**1. Open Integration**

Click on the connected integration.

**2. Click Disconnect**

Click **Disconnect** in the detail panel.

**3. Confirm**

Confirm you want to disconnect.

> [!WARNING]
>
> Disconnecting an integration will:
>
> * Disable deployments using that channel
> * Stop syncing knowledge from that source
> * Remove stored credentials

## Multi-Account Connections

Some integrations support multiple connections:

* **Gmail:** Connect multiple email accounts
* **Widget:** Create multiple chat widgets

For these integrations:

1. Click **Manage** to see connections
2. Click **Add Another** for additional accounts
3. Remove individual connections as needed

## Connection Types

### OAuth

Most integrations use OAuth for secure authentication:

1. Click Connect
2. Redirected to external service
3. Authorize Duckie
4. Redirected back, connected

**Integrations:** Slack, Zendesk, Notion, Jira, etc.

### API Key

Some integrations require manual API key entry:

1. Click Connect
2. Enter API key/token
3. Save credentials

**Integrations:** Plain, Pylon, Fireflies

## Troubleshooting

### Connection Failed

**Possible causes:**

* Don't have admin permissions in external platform
* Required scopes weren't approved
* Network or temporary issues

**Solutions:**

* Verify you have admin access
* Try disconnecting and reconnecting
* Check the external platform's status

### Sync Not Working

**Possible causes:**

* Connection expired
* Content not selected
* Permissions changed

**Solutions:**

* Check connection status
* Verify content selection
* Reconnect if needed

### Features Not Available

**Possible cause:**

* Integration doesn't support that feature

**Solution:**

* Check [Supported Integrations](https://docs.duckie.ai/integrations/supported-integrations.md) for capabilities

## Next Steps

> [card] [Supported Integrations](https://docs.duckie.ai/integrations/supported-integrations.md)
>
> See all integration capabilities

> [card] [Create Deployment](https://docs.duckie.ai/deployments/creating-deployments.md)
>
> Deploy to connected channels


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.