PHPackages                             testmonitor/clickup-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. testmonitor/clickup-client

ActiveLibrary[API Development](/categories/api)

testmonitor/clickup-client
==========================

The TestMonitor Clickup Client.

v1.1.0(2y ago)11.1k↓50%2MITPHPPHP ^8.1

Since Jan 25Pushed 1y ago2 watchersCompare

[ Source](https://github.com/testmonitor/clickup-client)[ Packagist](https://packagist.org/packages/testmonitor/clickup-client)[ RSS](/packages/testmonitor-clickup-client/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (4)Used By (0)

TestMonitor Clickup Client
==========================

[](#testmonitor-clickup-client)

[![Latest Stable Version](https://camo.githubusercontent.com/52d8391dd272d977dcdfcf567e4a40158b127909172baabb2d77901b1d74fe42/68747470733a2f2f706f7365722e707567782e6f72672f746573746d6f6e69746f722f636c69636b75702d636c69656e742f762f737461626c65)](https://packagist.org/packages/testmonitor/clickup-client)[![CircleCI](https://camo.githubusercontent.com/8d6d308c3416e084404188a19ce00f0aa7f7e23c24342810a59ea240709dec47/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f70726f6a6563742f6769746875622f746573746d6f6e69746f722f636c69636b75702d636c69656e742e737667)](https://circleci.com/gh/testmonitor/clickup-client)[![StyleCI](https://camo.githubusercontent.com/072021328faf1a132fa6e7fd1cffa38cdcd3867a316f0454fa1e3cb8d300a099/68747470733a2f2f7374796c6563692e696f2f7265706f732f3730353232363632332f736869656c64)](https://styleci.io/repos/705226623)[![codecov](https://camo.githubusercontent.com/5cb0749f02d0c29724cd29dcf31d441f500f221ab0df1b4eab55cb43be27628e/68747470733a2f2f636f6465636f762e696f2f67682f746573746d6f6e69746f722f636c69636b75702d636c69656e742f67726170682f62616467652e7376673f746f6b656e3d4a55555a4a39524e3246)](https://codecov.io/gh/testmonitor/clickup-client)[![License](https://camo.githubusercontent.com/b997dbf7f9c5dd633f55922231e3c9578ab95995e4eb7bcb2ad7644a263ae8a4/68747470733a2f2f706f7365722e707567782e6f72672f746573746d6f6e69746f722f636c69636b75702d636c69656e742f6c6963656e7365)](https://packagist.org/packages/testmonitor/clickup-client)

This package provides a very basic, convenient, and unified wrapper for [Clickup](https://clickup.com/).

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [Tests](#tests)
- [Changelog](#changelog)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)

Installation
------------

[](#installation)

To install the client you need to require the package using composer:

```
$ composer require testmonitor/clickup-client

```

Use composer's autoload:

```
require __DIR__.'/../vendor/autoload.php';
```

You're all set up now!

Usage
-----

[](#usage)

This client only supports **oAuth authentication**. You'll need an Clickup application to proceed. If you haven't done so, please read up with the [Clickup authentication docs](https://clickup.com/api/developer-portal/authentication#oauth-flow) on how to create an application.

When your Clickup application is up and running, start with the oAuth authorization:

```
$oauth = [
    'clientId' => '12345',
    'clientSecret' => 'abcdef',
    'redirectUrl' => 'https://redirect.myapp.com/',
];

$clickup = new \TestMonitor\Clickup\Client($oauth);

header('Location: ' . $clickup->authorizationUrl());
exit();
```

This will redirect the user to a page asking confirmation for your app getting access to Clickup. Make sure your redirectUrl points back to your app. This URL should point to the following code:

```
$oauth = [
    'clientId' => '12345',
    'clientSecret' => 'abcdef',
    'redirectUrl' => 'https://redirect.myapp.com/',
];

$clickup = new \TestMonitor\Clickup\Client($oauth);

$token = $clickup->fetchToken($_REQUEST['code']);
```

When everything went ok, you should have an access token (available through Token object). It will be valid for **one hour**. After that, you'll have to refresh the token to regain access:

```
$oauth = ['clientId' => '12345', 'clientSecret' => 'abcdef', 'redirectUrl' => 'https://redirect.myapp.com/'];
$token = new \TestMonitor\Clickup\AccessToken('eyJ0...'); // the token you got last time

$clickup = new \TestMonitor\Clickup\Client($oauth, $token);
```

Examples
--------

[](#examples)

Get a list of Clickup workspaces:

```
$workspaces = $clickup->workspaces();
```

Or creating a task, for example (using list id 12345):

```
$workItem = $clickup->createTask(new \TestMonitor\Clickup\Resources\Task([
    'name' => 'Name of the task',
    'description' => 'Some description',
]), '12345');
```

Tests
-----

[](#tests)

The package contains integration tests. You can run them using PHPUnit.

```
$ vendor/bin/phpunit

```

Changelog
---------

[](#changelog)

Refer to [CHANGELOG](CHANGELOG.md) for more information.

Contributing
------------

[](#contributing)

Refer to [CONTRIBUTING](CONTRIBUTING.md) for contributing details.

Credits
-------

[](#credits)

- **Thijs Kok** - *Lead developer* - [ThijsKok](https://github.com/thijskok)
- **Stephan Grootveld** - *Developer* - [Stefanius](https://github.com/stefanius)
- **Frank Keulen** - *Developer* - [FrankIsGek](https://github.com/frankisgek)

License
-------

[](#license)

The MIT License (MIT). Refer to the [License](LICENSE.md) for more information.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 56% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Total

2

Last Release

735d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/39f48c881813b7d3b044ca5660aa5ab9e60b5dd7c34ed4a47acbb11bd20b7593?d=identicon)[thijskok](/maintainers/thijskok)

---

Top Contributors

[![thijskok](https://avatars.githubusercontent.com/u/1344550?v=4)](https://github.com/thijskok "thijskok (14 commits)")[![stefanius](https://avatars.githubusercontent.com/u/2707905?v=4)](https://github.com/stefanius "stefanius (6 commits)")[![Frankisgek](https://avatars.githubusercontent.com/u/487218?v=4)](https://github.com/Frankisgek "Frankisgek (3 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (2 commits)")

---

Tags

apiclickupclientclientClickUptestmonitor

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/testmonitor-clickup-client/health.svg)

```
[![Health](https://phpackages.com/badges/testmonitor-clickup-client/health.svg)](https://phpackages.com/packages/testmonitor-clickup-client)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[resend/resend-php

Resend PHP library.

574.7M21](/packages/resend-resend-php)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[spinen/laravel-clickup

SPINEN's Laravel Package for ClickUp.

282.2k](/packages/spinen-laravel-clickup)[markrogoyski/numverify-api-client-php

Numverify API Client for PHP

1220.9k](/packages/markrogoyski-numverify-api-client-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)