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

# Support Platform Connectors

> How to connect Zendesk, Freshdesk, Jira, Intercom, HubSpot, or any custom platform to Fincelo's Support Intelligence Layer.

## Connecting a Platform

1. Fincelo → **Intelligence → Support → Connect Platform**
2. Select your platform
3. Enter credentials
4. Choose sync mode
5. Click **Test & Connect**

First sync starts within 15 minutes.

***

## Platform Credentials

### Zendesk

| Field       | Where to find                                                         |
| ----------- | --------------------------------------------------------------------- |
| Subdomain   | Your Zendesk URL prefix (e.g. `acmecorp` from `acmecorp.zendesk.com`) |
| Admin Email | Your Zendesk admin login email                                        |
| API Token   | Zendesk Admin → Apps & Integrations → Zendesk API → Add API Token     |

### Freshdesk

| Field     | Where to find                                         |
| --------- | ----------------------------------------------------- |
| Subdomain | Your Freshdesk URL prefix                             |
| API Key   | Profile icon (top right) → Profile Settings → API Key |

### Jira Service Management

| Field     | Where to find                                                                 |
| --------- | ----------------------------------------------------------------------------- |
| Subdomain | Your Atlassian subdomain                                                      |
| Email     | Your Atlassian account email                                                  |
| API Token | [id.atlassian.com](https://id.atlassian.com) → Security → API Tokens → Create |

### Intercom

| Field        | Where to find                                                |
| ------------ | ------------------------------------------------------------ |
| Access Token | Intercom → Settings → Developer Hub → New App → Access Token |

### HubSpot Service Hub

| Field             | Where to find                                                                |
| ----------------- | ---------------------------------------------------------------------------- |
| Private App Token | HubSpot → Settings → Integrations → Private Apps → Create (scope: `tickets`) |

***

## Sync Modes

| Mode                   | How it works                                    | Best for                                |
| ---------------------- | ----------------------------------------------- | --------------------------------------- |
| **Poll every 15 min**  | Fincelo calls the platform API every 15 minutes | Platforms without good webhook support  |
| **Real-time webhook**  | Platform pushes events to Fincelo instantly     | Low-latency alerting on hostile tickets |
| **Both (recommended)** | Webhook for real-time + polling as backup       | Production setup                        |

***

## Webhook URL

For real-time sync, configure this URL in your platform:

```
https://app.fincelo.app/api/webhooks/tickets?connectorId=YOUR_CONNECTOR_ID
```

Your connector ID is shown in Fincelo after connecting.

### Platform-specific webhook setup:

* **Zendesk:** Admin → Apps & Integrations → Webhooks → Add Webhook
* **Jira:** Project Settings → Webhooks → Create Webhook
* **Intercom:** Developer Hub → Webhooks → Add endpoint
* **Freshdesk:** Admin → Automations → On ticket update → Trigger webhook (manual setup required)
* **HubSpot:** Settings → Integrations → Webhooks (manual setup required)

***

## Sync History

View all sync activity: **Intelligence → Support → \[Connector name] → Sync History**

Shows: last sync time · tickets synced · errors · retry status

***

## Custom / Unsupported Platform

Any platform that can:

1. Push JSON events to a URL (webhook) → use the **Webhook Push** connector
2. Export data as CSV → use the **CSV Import** feature

[CSV Import guide →](/support-intelligence/csv-import)