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

# Connect Front

> | Field | Default | Notes | |-------|---------|-------| | Start date | One year ago | Earliest article activity to include.

<Tip>
  Configure the source at [**AI Training → Data Sources**](https://platform.open.cx/data-sources). This is separate from the [Front ticketing integration](/integrations/front/connect), though the same API token can power both.
</Tip>

## Set up the sync

<Steps>
  <Step title="Open Data Sources">
    Go to [**AI Training → Data Sources**](https://platform.open.cx/data-sources).
  </Step>

  <Step title="Add a Front source">
    Click **Add source → Front**.

    | Field          | Default      | Notes                                                                                                                                                        |
    | -------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **Start date** | One year ago | Earliest article activity to include. Pick a date in `YYYY-MM-DDTHH:mm` format — the form provides a date picker.                                            |
    | **API Key**    | —            | Front API token with **Knowledge Base: Read** scope. [Create one in the Front Developer Portal](https://dev.frontapp.com/docs/create-and-revoke-api-tokens). |
  </Step>

  <Step title="Select which Help Centers to sync">
    As soon as you paste a valid API key, OpenCX fetches the list of Help Centers on your Front account and shows them in a checkbox group with **type** (public / internal) and **locale** next to each name.

    * Leave all checked to sync every Help Center the token can read.
    * Uncheck internal Help Centers if you don't want their articles in the AI index.
    * Use **Select all** / **Deselect all** for quick toggling.

    <Warning>
      **Articles from unchecked Help Centers are filtered out at sync time** (`allowed_knowledge_base_ids` saved to your source config). If you later re-check a Help Center, articles from it start syncing on the next run.
    </Warning>
  </Step>

  <Step title="Start the sync">
    Click **Connect**. OpenCX saves your selection, creates the connection, and triggers the first sync. Progress shows on the source row.
  </Step>

  <Step title="Verify in AI Instructions">
    Open [**AI Training → AI Instructions**](https://platform.open.cx/ai-instructions). Articles appear grouped under **Front**. Confirm the eye icon matches expectations — internal Help Centers come in as **internal**, public as **public** (if published).
  </Step>
</Steps>

## What gets synced

<AccordionGroup>
  <Accordion title="Published articles from selected Help Centers" icon="file-lines">
    Each article is fetched twice internally: once for metadata (via Airbyte), then once more via the Front API to pull full content. The final record has title, body, and source URL.
  </Accordion>

  <Accordion title="Visibility per Help Center + per article" icon="eye">
    Two layers combined:

    * **KB type:** If the Help Center's `type` in Front is `internal`, every article from it is **internal** in OpenCX.
    * **Article status:** Within a non-internal Help Center, only `published` articles are **public**. Drafts and archived articles are **internal**.
  </Accordion>

  <Accordion title="Incremental updates" icon="arrows-rotate">
    Sync runs on the Airbyte schedule (typically every few hours). Only articles whose `updated_at` changed since the last run are fetched. New articles in selected Help Centers are picked up automatically.
  </Accordion>
</AccordionGroup>

## Limits

|                               | Value                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Streams synced**            | `knowledge_bases_articles`                                                                                   |
| **Sync mode**                 | `incremental_deduped_history` on `updated_at`                                                                |
| **Sync cadence**              | Airbyte polling — typically every few hours                                                                  |
| **Credential type**           | Front API token (no OAuth)                                                                                   |
| **Multi-account**             | One Front account per connection                                                                             |
| **Selective scoping**         | **Per-Help-Center via checkboxes.** Articles are not filterable at category or team level below Help Center. |
| **Archived / draft articles** | Synced as `internal`                                                                                         |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Front overview" icon="inbox" href="/knowledge/sources/front/overview">
    Scope and per-HC scoping summary.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/knowledge/sources/front/troubleshooting">
    KB list empty, private articles, re-sync.
  </Card>

  <Card title="Front integration" icon="inbox" href="/integrations/front/overview">
    Inbox, conversations, handoff.
  </Card>

  <Card title="Connect a knowledge source" icon="brain" href="/knowledge/sources/overview">
    All sources.
  </Card>
</CardGroup>