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

# OAuth integration setup

> Step-by-step guides for connecting Jira, Slack, and Figma via OAuth.

<Note>
  We support OAuth for five adapters: GitHub, Linear, Jira, Slack, Figma. Once connected, they stream live operational signal into your scoring dimensions.
</Note>

# OAuth integration setup

We support OAuth for five providers: GitHub, Linear, Jira, Slack, and Figma. Once connected, they stream live operational signal into your scoring dimensions.

<img src="https://mintcdn.com/dacard/Lj-FH3-8rSmqL1t4/images/integration-flow.svg?fit=max&auto=format&n=Lj-FH3-8rSmqL1t4&q=85&s=3d07f53320f302b6aaadda5138f87e59" alt="Integration flow: Connect via OAuth, Sync daily, Normalize to 378 signal types, Score across 27 dimensions" style={{ width: '100%', borderRadius: '12px', marginTop: '1rem', marginBottom: '2rem' }} width="1100" height="210" data-path="images/integration-flow.svg" />

## GitHub

<Steps>
  <Step title="Navigate to Sources">
    Go to **Sources** from the main navigation and click **Connect** next to GitHub.
  </Step>

  <Step title="Authorize">
    You will be redirected to GitHub to authorize Dacard. Grant access to the repositories you want to monitor.
  </Step>

  <Step title="Scopes granted">
    GitHub OAuth requests `repo` (repository access) and `read:org` (organization membership).
  </Step>

  <Step title="Verify">
    After authorization, you will be redirected back to Dacard. Your GitHub integration will show as **Connected** on the Sources page. Click **Sync now** to pull initial data.
  </Step>
</Steps>

**Signals produced:** Deploy frequency, PR velocity, review cycles, code review patterns, assisted-development detection.

***

## Linear

<Steps>
  <Step title="Navigate to Sources">
    Go to **Sources** and click **Connect** next to Linear.
  </Step>

  <Step title="Authorize">
    You will be redirected to Linear to authorize Dacard with `read` scope.
  </Step>

  <Step title="Select workspace">
    Choose which Linear team to sync. Issues are pulled on the next sync cycle or immediately via **Sync now**.
  </Step>
</Steps>

**Signals produced:** Issue cycle time, sprint velocity, backlog health, project completion rates (16 signal types).

***

## Jira (Atlassian Cloud)

<Steps>
  <Step title="Navigate to Sources">
    Go to **Sources** and click **Connect** next to Jira.
  </Step>

  <Step title="Authorize with Atlassian">
    You will be redirected to Atlassian's authorization page. Dacard uses the OAuth 2.0 (3LO) flow.
  </Step>

  <Step title="Select site">
    If you have multiple Atlassian sites, select the one containing the Jira project you want to connect.
  </Step>

  <Step title="Scopes granted">
    Jira OAuth requests `read:jira-work` (issues and projects), `read:jira-user` (team members), and `offline_access` (refresh tokens for continuous sync).
  </Step>
</Steps>

**Signals produced:** Issue completion rates, sprint metrics, backlog composition, cycle time.

<Note>
  Jira integration requires Jira Cloud (Atlassian-hosted). Jira Server and Jira Data Center are not currently supported.
</Note>

***

## Slack

<Steps>
  <Step title="Navigate to Sources">
    Go to **Sources** and click **Connect** next to Slack.
  </Step>

  <Step title="Authorize">
    You will be redirected to Slack to install the Dacard app in your workspace.
  </Step>

  <Step title="Scopes granted">
    Slack OAuth requests `channels:read` (channel list), `channels:history` (message history), `users:read` (team members), and `reactions:read` (emoji reactions).
  </Step>
</Steps>

**Signals produced:** Communication patterns, reaction engagement, channel activity metrics.

<Note>
  Dacard reads public channel data only. Private channels and direct messages are never accessed.
</Note>

***

## Figma

<Steps>
  <Step title="Navigate to Sources">
    Go to **Sources** and click **Connect** next to Figma.
  </Step>

  <Step title="Authorize">
    You will be redirected to Figma to authorize Dacard with `files:read` scope.
  </Step>
</Steps>

**Signals produced:** Design iteration frequency, design system usage patterns.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth popup was blocked">
    Disable your browser's popup blocker for app.dacard.ai and try again.
  </Accordion>

  <Accordion title="Authorization failed or timed out">
    Ensure you are logged into the correct account in the provider's service before clicking Connect. If the issue persists, try in an incognito window.
  </Accordion>

  <Accordion title="Integration shows Connected but no data">
    Click **Sync now** on the Sources page. Initial data pull can take up to 60 seconds. If data still does not appear, check that the connected account has access to the repositories, projects, or workspaces you expect.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="All integrations" icon="plug" href="/knowledge-base/integrations">
    Browse all 54 supported adapters.
  </Card>

  <Card title="How scoring works" icon="signal-bars" href="/knowledge-base/scoring">
    How adapter signal blends with the surface read.
  </Card>
</CardGroup>