# ClickUp integration (https://www.shipfox.io/docs/integrations/clickup)

Description: Connect a ClickUp workspace to receive task and comment events and call ClickUp tools from workflows.

## Authentication [#authentication]

Shipfox connects to ClickUp through OAuth and acts on behalf of the account that
authorizes it. That account's ClickUp permissions determine which resources
Shipfox can use and which events it can receive.

Use a dedicated ClickUp user account as a service account, not a personal
account. Name it Shipfox so its actions are easy to identify, and grant it only
the access it needs.

## Integration connection identity [#integration-connection-identity]

When you connect ClickUp, choose the workspace Shipfox should search and receive
events from. A workflow can still update a task in another workspace when it
supplies that task's ID and the connected account has access.

The slug of a ClickUp integration connection defaults to
`clickup_<workspace>`, where `<workspace>` is the normalized ClickUp workspace
name. For example, `clickup_acme`. Shipfox makes the slug unique within the
Shipfox workspace.

Use the slug as `source` for ClickUp events:

```yaml
triggers:
  on_clickup_comment:
    source: clickup_acme
    event: taskCommentPosted
```

For trigger field rules, see the [workflow schema reference](https://www.shipfox.io/docs/reference/workflow-schema#trigger-fields).

## Capabilities [#capabilities]

| Capability | Details                                              |
| ---------- | ---------------------------------------------------- |
| Events     | [View ClickUp events](https://www.shipfox.io/docs/integrations/clickup/events). |
| Tools      | [View ClickUp tools](https://www.shipfox.io/docs/integrations/clickup/tools).   |

[Connect ClickUp](https://www.shipfox.io/docs/integrations/clickup/setup) to create an integration connection.