PHPackages edsol/php-clickup-api-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. edsol/php-clickup-api-client ActiveLibrary[API Development](/categories/api) edsol/php-clickup-api-client ============================ ClickUp V2 API client (unofficial) 62023PHP Since May 29Pushed 11mo ago1 watchersCompare [ Source](https://github.com/Edsol/php-clickup-api-client)[ Packagist](https://packagist.org/packages/edsol/php-clickup-api-client)[ RSS](/packages/edsol-php-clickup-api-client/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Unofficial [ClickUp](http://clickup.com) API Client see [ClickUp Api Docs](https://clickup.com/api) ==================================================================================================== [![License: AGPL v3](https://camo.githubusercontent.com/c61341f63648cdd5aba4f7a073b513106a63778c27b15f96c56157642bc943b4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4147504c25323076332d626c75652e737667)](https://www.gnu.org/licenses/agpl-3.0)[![ ](https://camo.githubusercontent.com/0c539fe1706817f90f257036a3e872d3057f76d238ec122e0da47fbc572609b5/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f76657273696f6e2d73686f72742f6564736f6c2e636c69636b75702e737667)](https://camo.githubusercontent.com/0c539fe1706817f90f257036a3e872d3057f76d238ec122e0da47fbc572609b5/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f76657273696f6e2d73686f72742f6564736f6c2e636c69636b75702e737667)[![ ](https://camo.githubusercontent.com/7aa46d76c8458b0fa47f933be2d27ce69acce2b1cc4a8492e46e531bc1db9cdc/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f646f776e6c6f6164732d73686f72742f6564736f6c2e636c69636b75702e737667)](https://camo.githubusercontent.com/7aa46d76c8458b0fa47f933be2d27ce69acce2b1cc4a8492e46e531bc1db9cdc/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f646f776e6c6f6164732d73686f72742f6564736f6c2e636c69636b75702e737667)[![ ](https://camo.githubusercontent.com/54e118d124eb6b7a78d4e20e5e42fbf5d4dc0228fa08a18fd8069b78205199e3/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f726174696e672d73686f72742f6564736f6c2e636c69636b75702e737667)](https://camo.githubusercontent.com/54e118d124eb6b7a78d4e20e5e42fbf5d4dc0228fa08a18fd8069b78205199e3/68747470733a2f2f76736d61726b6574706c61636562616467652e61707068622e636f6d2f726174696e672d73686f72742f6564736f6c2e636c69636b75702e737667) [](#unofficial-clickup-api-client-see-clickup-api-docs) Requirements ------------ [](#requirements) You need to have a ClickUp token, use [official guide](https://docs.clickup.com/en/articles/1367130-getting-started-with-the-clickup-api) to create one Install ------- [](#install) ``` composer require edsol/php-clickup-api-client ``` Implementations --------------- [](#implementations) ### Team [](#team) - Read - get Spaces ### Space [](#space) - Read - get Tags ### Folder [](#folder) - Create - Read - Create List ### Task [](#task) - Create - Read - Update - Delete - Add attachment/s - Add assignee/s - Get members ### Comment [](#comment) - Read - Create - Update - Delete ### Webhook [](#webhook) - List - Create - Update - Delete Usage ----- [](#usage) First, initialize the client: ``` $clickup = new \ClickUpClient\Client('CLICK_UP_API_TOKEN'); ``` ### Team [](#team-1) ``` $clickup->team()->all(); $clickup->team()->spaces(); $clickup->team()->user('USER_ID'); ``` ### Space [](#space-1) ``` $clickup->space()->get("SPACE_ID"); $clickup->space('SPACE_ID')->tags(); $clickup->space('SPACE_ID')->folders(); $clickup->space('SPACE_ID')->folderlessLists(); ``` ### Folder [](#folder-1) ``` $clickup->folder("SPACE_ID")->lists(); $clickup->folder("FOLDER_ID")->get(); $clickup->folder()->get("FOLDER_ID"); $clickup->folder("SPACE_ID")->create("FOLDER_NAME"); $clickup->folder("SPACE_ID")->createList("LIST_NAME"); ``` ### List [](#list) ``` $clickup->taskList("LIST_ID")->get(); $clickup->taskList("LIST_ID")->getTasks(); $clickup->taskList("LIST_ID")->comments(); $clickup->taskList("LIST_ID")->members(); $clickup->taskList("LIST_ID")->getCustomFields(); ``` ### Task [](#task-1) ``` $clickup->task("TASK_ID")->get(); $clickup->task("TASK_ID")->comments(); $clickup->task("TASK_ID")->members(); $clickup->task("TASK_ID")->add([ "name": "Updated Task Name", "description": "Updated Task Content", ]); $clickup->task("TASK_ID")->delete(); $clickup->task("TASK_ID")->update([ "name": "Updated Task Name", "description": "Updated Task Content" ]); $clickup->task("TASK_ID")->addAssignees([ MEMBER_ID_1, MEMBER_ID_2, ]); $clickup->task("TASK_ID")->addAssignee(MEMBER_ID); $attachment = new \ClickUpClient\Objects\Attachment([ 'contents' => \GuzzleHttp\Psr7\Utils::tryFopen('FILE_PATH', 'r'), 'filename' => 'filename.txt' ]); $clickup->task("TASK_ID")->addAttachment($attachment); $attachments = new \ClickUpClient\Objects\AttachmentCollection([ [ 'contents' => \GuzzleHttp\Psr7\Utils::tryFopen('FILE_PATH', 'r'), 'filename' => 'filename1.txt' ], [ 'contents' => \GuzzleHttp\Psr7\Utils::tryFopen('FILE_PATH', 'r'), 'filename' => 'filename2.txt' ], ]); $clickup->task("TASK_ID")->addAttachments($attachments); $clickup->task("TASK_ID")->setCustomField("FIELD_ID","NEW_FIELD_VALUE"); $clickup->task("TASK_ID")->deleteCustomField("FIELD_ID"); ``` ### Comment [](#comment-1) ``` $clickup->comment('COMMENT_ID')->update([ 'comment_text' => "update comment text" ]); $clickup->comment()->deleteComment('COMMENT_ID'); ``` ### Webhook [](#webhook-1) ``` $clickup->team('TEAM_ID')->webhooks(); $clickup->team('TEAM_ID')->createWebhook([ 'endopint' => 'ENDPOINT_URL', 'events' => [ "taskCreated", "taskUpdated", "taskDeleted", ], ]); $clickup->webhook('WEBHOOK_ID')->updateWebhook([ 'endopint' => 'ENDPOINT_URL', 'events' => [ "taskCreated", "taskUpdated", "taskDeleted", ], ]); $clickup->webhook('WEBHOOK_ID')->delete(); ``` #### Webhook payloads classes [](#webhook-payloads-classes) This package also provides classes to strongly type the payloads received from webhooks. For example: ``` // If your request body is an array, you need to convert it to an object $request_body_object = json_decode(json_encode($request_body_array), false); $task_comment_posted_payload = new \ClickUpClient\Objects\Webhook\Task\TaskCommentPostedPayload($request_body_object); ``` This allows you to work with a fully typed webhook payload, making it easier to handle and access its data within your application. ##### Space [](#space-2) - spaceCreated - spaceUpdated - spaceDeleted ##### Folder [](#folder-2) - folderCreated - folderUpdated - folderDeleted ##### List [](#list-1) - listCreated - listUpdated - listDeleted ##### Task [](#task-2) - taskCreated - taskUpdated - taskDeleted - taskPriorityUpdated - taskStatusUpdated - taskAssigneeUpdated - taskDueDateUpdated - taskTagUpdated - taskMoved - taskCommentPosted - taskCommentUpdated - taskTimeEstimateUpdated - taskTimeTrackedUpdated ### Health Score 22 — LowBetter than 22% of packages Maintenance37 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community12 Small or concentrated contributor base Maturity14 Early-stage or recently created project Bus Factor2 2 contributors hold 50%+ of commits 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/1bb21d2eb71468f2e1714fe5557c4340f2b17b713c35d8876adb25ad80777aab?d=identicon)[EdsolXY](/maintainers/EdsolXY) --- Top Contributors [![antogno](https://avatars.githubusercontent.com/u/84918191?v=4)](https://github.com/antogno "antogno (7 commits)")[![dorgan](https://avatars.githubusercontent.com/u/464851?v=4)](https://github.com/dorgan "dorgan (5 commits)")[![Edsol](https://avatars.githubusercontent.com/u/19670024?v=4)](https://github.com/Edsol "Edsol (4 commits)") --- Tags apiapi-clientapi-client-phpclickupphp ### Embed Badge ![Health badge](/badges/edsol-php-clickup-api-client/health.svg) ``` [![Health](https://phpackages.com/badges/edsol-php-clickup-api-client/health.svg)](https://phpackages.com/packages/edsol-php-clickup-api-client) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 265103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)