# Integrations
URL: https://docs.clearly-ai.com/docs/integrations
Description: Connect external systems as Project sources and Workflow actions.
Integrations let Clearly AI authenticate to external systems and turn their records into usable context or automation targets.

Use integrations to:

* Add tickets, code, documents, assets, and web content as **Project sources** for Reviews and Chat.
* Trigger Workflows from external events, such as Jira, Linear, Azure DevOps, GitHub, and ServiceNow updates.
* Send Review output back to the tools your team already uses, such as comments, tickets, attachments, Slack messages, SharePoint files, and OneTrust assessments.

<Cards>
  <Card title="Issue trackers" href="/docs/integrations/issue-trackers/jira" description="Connect ticketing and work management systems." />

  <Card title="Documents" href="/docs/integrations/documents/confluence" description="Connect document and knowledge sources." />

  <Card title="Code repositories" href="/docs/integrations/code/github" description="Connect repositories used as Project context." />

  <Card title="Communication" href="/docs/integrations/communication/slack" description="Connect messaging tools." />

  <Card title="OneTrust" href="/docs/integrations/governance/onetrust" description="Read OneTrust assets and publish Review answers to OneTrust assessments." />

  <Card title="Snyk" href="/docs/integrations/security/snyk" description="Import Snyk vulnerability and code-security findings as Clearly AI project sources." />

  <Card title="Wiz" href="/docs/integrations/security/wiz" description="Import Wiz Projects and posture findings as Clearly project sources." />
</Cards>

## How integrations work [#how-integrations-work]

Each integration is built around external **entities**, such as a Jira issue, Linear issue, Azure DevOps branch, SharePoint file, or OneTrust asset. When you add one of those entities to a Project, Clearly AI calls the right fetch endpoint and stores the fetched content as a source.

The same entity model powers Workflows. A trigger can emit an entity, such as a Linear issue or Azure DevOps work item, and later steps can comment on it, assign it, attach a Review export, or use it as Project context.

## Auth patterns [#auth-patterns]

Clearly AI integrations use one of these authentication patterns.

* **OAuth 2.0**: User-authorized access through the provider's consent flow.
* **Client credentials**: Service-account or machine-to-machine access. Use this when the integration should act as an application or service account.
* **Shared API Token**: A token you create in the provider and paste into Clearly AI. Use this when OAuth 2.0 is unavailable or when your team wants to manage token rotation directly.

## Who a connection belongs to [#who-a-connection-belongs-to]

An integration can have two kinds of connection:

* **Shared (Workspace)**: an admin adds it in **Organization settings** > **Integrations**. Anyone in your Clearly AI organization can use it.
* **Personal (User)**: a person connects their own account in **Customize**, on the **Yours** tab. A service appears there only after an admin installs its connector. Sources and Workflows that run as that person use it.

**Warning:** Every Clearly AI user in your tenant shares a Shared (Workspace) connection. Sign in with a system or service account, not an employee's personal account.

## Add an integration source to a Project [#add-an-integration-source-to-a-project]

1. Open a Project.
2. Open **Manage Sources**.
3. Click **Search Integrations**.
4. Choose the connected integration.
5. Select the external item you want to include, such as a repository branch, issue, work item, document, or OneTrust asset.
6. Save the source and wait for processing to finish.

[Image: Adding a GitHub repository via Search Integrations]

If the source is large, narrow the selection where the connector allows it. Code repository sources can include or exclude file patterns.

## Connector setup [#connector-setup]

* [GitHub](https://docs.clearly-ai.com/docs/integrations/code/github): OAuth 2.0 or Shared API Token
* [GitLab](https://docs.clearly-ai.com/docs/integrations/code/gitlab): Shared API Token
* [Azure Repos](https://docs.clearly-ai.com/docs/integrations/code/azure-repos): Shared API Token
* [Bitbucket](https://docs.clearly-ai.com/docs/integrations/code/bitbucket): Shared API Token
* [Jira](https://docs.clearly-ai.com/docs/integrations/issue-trackers/jira): Shared API Token
* [Azure DevOps Work Items](https://docs.clearly-ai.com/docs/integrations/issue-trackers/azure-devops-work-items): Shared API Token
* [Linear](https://docs.clearly-ai.com/docs/integrations/issue-trackers/linear): OAuth 2.0 or Shared API Token
* [Figma](https://docs.clearly-ai.com/docs/integrations/documents/figma): Shared API Token
* [ServiceNow](https://docs.clearly-ai.com/docs/integrations/issue-trackers/service-now): OAuth 2.0 client credentials
* [Archer IRM](https://docs.clearly-ai.com/docs/integrations/governance/archer): Shared API Token, set up with the Clearly AI team
* [OneTrust](https://docs.clearly-ai.com/docs/integrations/governance/onetrust): OAuth 2.0 client credentials
* [Snyk](https://docs.clearly-ai.com/docs/integrations/security/snyk): Shared API Token
* [Wiz](https://docs.clearly-ai.com/docs/integrations/security/wiz): OAuth 2.0 client credentials

## Related [#related]

* [Figma](https://docs.clearly-ai.com/docs/integrations/documents/figma) - Connect Clearly AI to Figma and FigJam
* [Notion](https://docs.clearly-ai.com/docs/integrations/documents/notion) - Connect Clearly AI to Notion using OAuth
* [SharePoint](https://docs.clearly-ai.com/docs/integrations/documents/sharepoint) - Connect Clearly AI to SharePoint using OAuth
* [Workflows](https://docs.clearly-ai.com/docs/workflows) - Trigger Reviews and send results back to connected tools