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

# ClickUp

> Connect ClickUp to Iru Compliance with a personal API token sent in the Authorization header (no Bearer prefix) to collect workspace, team, and task evidence.

### About ClickUp

Iru reads **workspaces**, **spaces**, **folders**, **lists**, **tasks**, and **members** from the ClickUp API. ClickUp **personal tokens** look like **`pk_…`** and must be sent as the **raw** **`Authorization`** header value - **do not** prefix **`Bearer`**, or authentication fails.

### How It Works

```http theme={null}
Authorization: pk_XXXXXXXXXXXXXXXX
```

| Detail             | Value                       |
| ------------------ | --------------------------- |
| **Category**       | Work management             |
| **Authentication** | Personal API token (`pk_…`) |

Official references: [Authentication](https://developer.clickup.com/docs/authentication), [API reference](https://developer.clickup.com/reference), [Help Center](https://help.clickup.com/hc/en-us/articles/6303426241687-Use-the-ClickUp-API).

### Prerequisites

* ClickUp user who is a member of every **workspace** you want evidence for.

### Connect ClickUp to Iru

<Tabs>
  <Tab title="ClickUp">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to ClickUp">
        Open [ClickUp](https://clickup.com) and sign in with a user who is a member of every **workspace** Iru should read.
      </Step>

      <Step title="Open your avatar menu">
        Select your **Avatar** (profile photo or initials) in the lower-left or header, depending on your ClickUp layout.
      </Step>

      <Step title="Open Settings and Apps">
        Choose **Settings**, then **Apps** (or **ClickApps** / **Integrations** if your tenant routes API tokens there; use the path that exposes **API Token**).
      </Step>

      <Step title="Open API Token">
        Select **API Token** to view existing tokens and the control to create a new one.
      </Step>

      <Step title="Generate a personal API token">
        Select **Generate** (or **Create token**) to mint a new **`pk_…`** token.
      </Step>

      <Step title="Copy the token value">
        Copy the full **`pk_`** string. **Regenerate** invalidates the prior token, so update Iru the same day if you rotate.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**ClickUp**](#clickup) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on ClickUp">
        Find **ClickUp** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Paste the personal API token">
        Paste **`pk_…`** into the **Authorization** field **without** **`Bearer`**.
      </Step>

      <Step title="Finish the connection">
        Click **Submit API Key**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **ClickUp** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 after adding Bearer">
    Remove **`Bearer`** - only the token string belongs in the header.
  </Accordion>

  <Accordion title="Missing workspace">
    Token’s user must join that workspace.
  </Accordion>

  <Accordion title="Broken after rotate">
    Paste the **new** `pk_` token in Iru.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>