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

# ClickUp

# Connector Details

| Name           | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platform       | [ClickUp](https://clickup.com)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Auth Type      | API Keys                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Direction      | Bidirectional                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Tap Repo       | [https://github.com/AutoIDM/tap-clickup](https://github.com/AutoIDM/tap-clickup)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Target Repo    | [https://gitlab.com/hotglue/target-clickup](https://gitlab.com/hotglue/target-clickup)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Tap Metrics    | <p>Usage: <Tooltip tip="low"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip><br />Success Rate: <Tooltip tip="high"><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /></Tooltip></p>         |
| Target Metrics | <p>Usage: <Tooltip tip="low"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip><br />Success Rate: <Tooltip tip="medium"><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip></p> |

# Credentials Setup

Follow the steps below to get the credentials you need to use the ClickUp connector.

## API Key

The first thing you need to do is log in to [ClickUp](https://clickup.com). They have a free tier, so if you don't have an account, you can make one.

![](https://files.readme.io/06e13a6-Screen_Shot_2021-11-17_at_11.56.44_AM.png "Screen Shot 2021-11-17 at 11.56.44 AM.png")

Your home page should look something like this. On the bottom left side of the screen, you should click your icon.

![](https://files.readme.io/6f4bfdb-Screen_Shot_2021-11-17_at_12.40.08_PM.png "Screen Shot 2021-11-17 at 12.40.08 PM.png")

You should now see a menu of items. You should go ahead and select the **My Settings** option.

![](https://files.readme.io/840de92-Screen_Shot_2021-11-17_at_12.40.41_PM.png "Screen Shot 2021-11-17 at 12.40.41 PM.png")

Now you should be in the **My Settings** page. From here, you should scroll down on the left-sided tool bar until you reach the **My Apps** category. Once you've reached the category, select the **Apps** section.

![](https://files.readme.io/56c939e-Screen_Shot_2021-11-17_at_12.41.58_PM.png "Screen Shot 2021-11-17 at 12.41.58 PM.png")

Now, you should be on a page where you can generate an API token. Go ahead and click the **Generate** button in order to create your API Token.

![](https://files.readme.io/0ebf60e-Screen_Shot_2021-11-17_at_12.44.05_PM.png "Screen Shot 2021-11-17 at 12.44.05 PM.png")

You have now generated your API Token. Go ahead and copy it.

![](https://files.readme.io/22f16df-Screen_Shot_2021-11-17_at_12.45.41_PM.png "Screen Shot 2021-11-17 at 12.45.41 PM.png")

Now you should go ahead and take the credential you generated in put it in hotglue!

# Tap Changelog

<Accordion title="Tap Changelog">
  | Version                                                                                     | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | :------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | [v0.0.23](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.23)                      | ## What's Changed<br />\* Patch is\_boolean\_type to fix custom\_fields values by @claudenigma in [https://github.com/AutoIDM/tap-clickup/pull/150](https://github.com/AutoIDM/tap-clickup/pull/150)<br /><br />## New Contributors<br />\* @claudenigma made their first contribution in [https://github.com/AutoIDM/tap-clickup/pull/150](https://github.com/AutoIDM/tap-clickup/pull/150)<br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.22...v0.0.23](https://github.com/AutoIDM/tap-clickup/compare/v0.0.22...v0.0.23)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | [v0.0.22](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.22)                      | ## What's Changed<br />\* Task time\_estimate can be a floating point number by @mcarriere in [https://github.com/AutoIDM/tap-clickup/pull/147](https://github.com/AutoIDM/tap-clickup/pull/147)<br />\* Release v0.0.22 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/148](https://github.com/AutoIDM/tap-clickup/pull/148)<br /><br />## New Contributors<br />\* @mcarriere made their first contribution in [https://github.com/AutoIDM/tap-clickup/pull/147](https://github.com/AutoIDM/tap-clickup/pull/147) , thank you!<br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.21...v0.0.22](https://github.com/AutoIDM/tap-clickup/compare/v0.0.21...v0.0.22)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | [v0.0.21](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.21)                      | ## What's Changed<br />\* Weekly workflow run by @sebastianswms in [https://github.com/AutoIDM/tap-clickup/pull/141](https://github.com/AutoIDM/tap-clickup/pull/141)<br />  \* This updates the SDK which fixes a problem where incremental keys were not being automatically added to the selected fields for a stream causing  [https://github.com/AutoIDM/tap-clickup/issues/140](https://github.com/AutoIDM/tap-clickup/issues/140)<br /><br />## New Contributors<br />\* @sebastianswms made their first contribution in [https://github.com/AutoIDM/tap-clickup/pull/141](https://github.com/AutoIDM/tap-clickup/pull/141)<br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.20...v0.0.21](https://github.com/AutoIDM/tap-clickup/compare/v0.0.20...v0.0.21)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | [v0.0.20](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.20)                      | ## What's Changed<br />\* Time Entries docs update by @visch in [https://github.com/AutoIDM/tap-clickup/pull/135](https://github.com/AutoIDM/tap-clickup/pull/135)<br />\* 3.10, 3.11 support by @visch in [https://github.com/AutoIDM/tap-clickup/pull/136](https://github.com/AutoIDM/tap-clickup/pull/136) <br />\* date\_done added by @visch in [https://github.com/AutoIDM/tap-clickup/pull/138](https://github.com/AutoIDM/tap-clickup/pull/138) Thank you to @JohannesRudolph<br />\* label\_fix by @visch in [https://github.com/AutoIDM/tap-clickup/pull/139](https://github.com/AutoIDM/tap-clickup/pull/139) Thank you to @balmasi<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.19...v0.0.20](https://github.com/AutoIDM/tap-clickup/compare/v0.0.19...v0.0.20)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | [v0.0.19](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.19)                      | ## What's Changed<br />\* Update test comments by @visch in [https://github.com/AutoIDM/tap-clickup/pull/124](https://github.com/AutoIDM/tap-clickup/pull/124)<br />\* Fixes Schema flattening issues by @visch in [https://github.com/AutoIDM/tap-clickup/pull/129](https://github.com/AutoIDM/tap-clickup/pull/129)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.18...v0.0.19](https://github.com/AutoIDM/tap-clickup/compare/v0.0.18...v0.0.19)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | [v0.0.18](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.18)                      | ## What's Changed<br />\* v0.0.17 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/120](https://github.com/AutoIDM/tap-clickup/pull/120)<br />\* Fixed Schema issues @visch in [https://github.com/AutoIDM/tap-clickup/pull/122](https://github.com/AutoIDM/tap-clickup/pull/122)<br />\* Release 0.0.18 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/123](https://github.com/AutoIDM/tap-clickup/pull/123)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.17...v0.0.18](https://github.com/AutoIDM/tap-clickup/compare/v0.0.17...v0.0.18)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | [v0.0.17](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.17)                      | ## What's Changed<br />\* State for Tasks by @visch in [https://github.com/AutoIDM/tap-clickup/pull/117](https://github.com/AutoIDM/tap-clickup/pull/117)<br />\* fixed custom fields Double by adding number to the schema by @lpearson-trek10 in [https://github.com/AutoIDM/tap-clickup/pull/116](https://github.com/AutoIDM/tap-clickup/pull/116)<br />\* Dropped support for python 3.6<br /><br /><br />## New Contributors<br />\* @lpearson-trek10 made their first contribution in [https://github.com/AutoIDM/tap-clickup/pull/116](https://github.com/AutoIDM/tap-clickup/pull/116) . Thank you!<br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.16...v0.0.17](https://github.com/AutoIDM/tap-clickup/compare/v0.0.16...v0.0.17)<br />Pypi: [https://pypi.org/project/tap-clickup/0.0.17/](https://pypi.org/project/tap-clickup/0.0.17/)<br /><br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | [v0.0.16](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.16)                      | ## What's Changed<br />\* Fix for time\_entries by @visch in [https://github.com/AutoIDM/tap-clickup/pull/113](https://github.com/AutoIDM/tap-clickup/pull/113)<br />\* v0.0.16 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/115](https://github.com/AutoIDM/tap-clickup/pull/115)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.15...v0.0.16](https://github.com/AutoIDM/tap-clickup/compare/v0.0.15...v0.0.16)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  | [v0.0.15](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.15)                      | ## What's Changed<br />\* Fixed Lint issues, and removed State from docs by @visch in [https://github.com/AutoIDM/tap-clickup/pull/102](https://github.com/AutoIDM/tap-clickup/pull/102)<br />\* Remove python 3.6 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/107](https://github.com/AutoIDM/tap-clickup/pull/107)<br />\* Added a ref Resolver by @visch in [https://github.com/AutoIDM/tap-clickup/pull/105](https://github.com/AutoIDM/tap-clickup/pull/105)<br />\* Added time entries stream by @visch in [https://github.com/AutoIDM/tap-clickup/pull/110](https://github.com/AutoIDM/tap-clickup/pull/110)<br />\* v0.0.15 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/111](https://github.com/AutoIDM/tap-clickup/pull/111)<br />\* \* Trek10 logo added by @visch in [https://github.com/AutoIDM/tap-clickup/pull/106](https://github.com/AutoIDM/tap-clickup/pull/106)<br />\* \* License update by @visch in [https://github.com/AutoIDM/tap-clickup/pull/103](https://github.com/AutoIDM/tap-clickup/pull/103)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.14...v0.0.15](https://github.com/AutoIDM/tap-clickup/compare/v0.0.14...v0.0.15)                                                                                                                                                              |
  | [v0.0.14](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.14)                      | ## What's Changed<br />\* Resolve Issue #92 - Schema Validation Failure  by @drewipson in [https://github.com/AutoIDM/tap-clickup/pull/94](https://github.com/AutoIDM/tap-clickup/pull/94)<br />\* Fix schema issue with for shared hierarchy and custom field items by @LucasZielke in [https://github.com/AutoIDM/tap-clickup/pull/96](https://github.com/AutoIDM/tap-clickup/pull/96)<br />\* Added Archived Streams for Lists, Folders, Spaces<br />\* Combined Task Streams<br /><br />## New Contributors<br />\* @drewipson made their first contribution in [https://github.com/AutoIDM/tap-clickup/pull/94](https://github.com/AutoIDM/tap-clickup/pull/94)<br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.13...v0.0.14](https://github.com/AutoIDM/tap-clickup/compare/v0.0.13...v0.0.14)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | [v0.0.13](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.13)                      | ## What's Changed<br />\* Fixed url param error by @LucasZielke in [https://github.com/AutoIDM/tap-clickup/pull/84](https://github.com/AutoIDM/tap-clickup/pull/84)<br />\* 0.0.13 release by @visch in [https://github.com/AutoIDM/tap-clickup/pull/85](https://github.com/AutoIDM/tap-clickup/pull/85)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.12...v0.0.13](https://github.com/AutoIDM/tap-clickup/compare/v0.0.12...v0.0.13)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | [v0.0.12](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.12)                      | ## What's Changed<br />\* Archived bug introduced in v0.0.11 , fixed. Archived tasks split out as archived=true doesn't include non archive… by @visch in [https://github.com/AutoIDM/tap-clickup/pull/81](https://github.com/AutoIDM/tap-clickup/pull/81)<br />\* Added two new streams for \_archived tasks<br />\* 0.0.12 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/82](https://github.com/AutoIDM/tap-clickup/pull/82)<br /><br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.11...v0.0.12](https://github.com/AutoIDM/tap-clickup/compare/v0.0.11...v0.0.12)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
  | [v0.0.11](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.11)                      | ## What's Changed<br />\* folder\_tasks were missing closed, and subtasks. Both folderless and f… by @visch in [https://github.com/AutoIDM/tap-clickup/pull/77](https://github.com/AutoIDM/tap-clickup/pull/77)<br />\* Version bump 0.0.11 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/78](https://github.com/AutoIDM/tap-clickup/pull/78)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.10...v0.0.11](https://github.com/AutoIDM/tap-clickup/compare/v0.0.10...v0.0.11)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | [v0.0.10](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.10)                      | ## What's Changed<br />\* Custom fields can also be jsonobjects, specefically manual\_progress\_t… by @visch in [https://github.com/AutoIDM/tap-clickup/pull/73](https://github.com/AutoIDM/tap-clickup/pull/73)<br />\* 0.0.10 version bump by @visch in [https://github.com/AutoIDM/tap-clickup/pull/75](https://github.com/AutoIDM/tap-clickup/pull/75)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.9...v0.0.10](https://github.com/AutoIDM/tap-clickup/compare/v0.0.9...v0.0.10)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | [v0.0.9](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.9)                        | ## What's Changed<br />\* Changed default Python runner for CI to python 3.9 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/63](https://github.com/AutoIDM/tap-clickup/pull/63)<br />\* Followed Stich documentation guidelines by @visch in [https://github.com/AutoIDM/tap-clickup/pull/66](https://github.com/AutoIDM/tap-clickup/pull/66)<br />\* Remove unused lists stream by @visch in [https://github.com/AutoIDM/tap-clickup/pull/67](https://github.com/AutoIDM/tap-clickup/pull/67)<br />\* Added PyPi to ReadMe, and added additional information on the pypi di… by @visch in [https://github.com/AutoIDM/tap-clickup/pull/68](https://github.com/AutoIDM/tap-clickup/pull/68)<br />\* Cleanup unused code, removed file that's not needed by @visch in [https://github.com/AutoIDM/tap-clickup/pull/69](https://github.com/AutoIDM/tap-clickup/pull/69)<br />\* Added Folder Lists for Custom Fields, changing the output tables for … by @visch in [https://github.com/AutoIDM/tap-clickup/pull/70](https://github.com/AutoIDM/tap-clickup/pull/70)<br />\* Bump version to 0.0.9 by @visch in [https://github.com/AutoIDM/tap-clickup/pull/71](https://github.com/AutoIDM/tap-clickup/pull/71)<br /><br /><br />**Full Changelog**: [https://github.com/AutoIDM/tap-clickup/compare/v0.0.8...v0.0.9](https://github.com/AutoIDM/tap-clickup/compare/v0.0.8...v0.0.9) |
  | [v0.0.8](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.8)                        | Fixed Shared Hierarchy bug that was caught by target-stitch. Two issues solved<br /><br />1. Upgraded SingerSDK as [https://gitlab.com/meltano/sdk/-/blob/main/CHANGELOG.md#changes-3](https://gitlab.com/meltano/sdk/-/blob/main/CHANGELOG.md#changes-3) was causing key-properties to be null for shared hierarchy<br />2. Updated the Shared Hirerarchy json to match the data we have been able to see so far. The API docs don't give a lot of insight into what that data is going to look like                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | [v0.0.7 (not released to pypi)](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.7) | Fixed Shared Hierarchy bug that was caught by target-stitch. Two issues solved<br /><br />1. Upgraded SingerSDK as [https://gitlab.com/meltano/sdk/-/blob/main/CHANGELOG.md#changes-3](https://gitlab.com/meltano/sdk/-/blob/main/CHANGELOG.md#changes-3) was causing key-properties to be null for shared hierarchy<br />2. Updated the Shared Hirerarchy json to match the data we have been able to see so far. The API docs don't give a lot of insight into what that data is going to look like                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | [v0.0.6](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.6)                        | Removed date-time format! Thank you @LucasZielke                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | [v0.0.5](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.5)                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | [v0.0.4](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.4)                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | [v0.0.3](https://github.com/AutoIDM/tap-clickup/releases/tag/v0.0.3)                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
</Accordion>
