ClickUp

Overview

Connect your users to ClickUp for project management, task tracking, and team collaboration.

Property	Value
Provider ID	clickup
Category	Productivity
PKCE	Supported
Token refresh	Not supported (permanent tokens)
Redirect URI	Shown in Developer Portal

Step 1: Create a ClickUp OAuth App

Go to ClickUp Integrations

Navigate to ClickUp Settings → Apps and sign in.

Create an app

Click Create an App.

Configure the application

Enter the app name and add the Redirect URI from the Developer Portal as the Redirect URL.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add ClickUp provider

Go to OAuth Providers > Add Provider > ClickUp.

Enter credentials

• Client ID: Paste your ClickUp Client ID
• Client Secret: Paste your ClickUp Client Secret

Save

Click Save. The provider is now active.

Notes

• ClickUp does not use scopes. The OAuth token grants access based on the user’s workspace permissions.
• ClickUp access tokens do not expire and there is no refresh token flow.
• See the ClickUp authentication documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
CreateChatViewComment	send	POST	/v2/view/{view_id}/comment
CreateListComment	send	POST	/v2/list/{list_id}/comment
CreateTaskComment	send	POST	/v2/task/{task_id}/comment
CreateThreadedComment	send	POST	/v2/comment/{comment_id}/reply
InviteGuestToWorkspace	admin, send	POST	/v2/team/{team_id}/guest
InviteUserToWorkspace	admin, send	POST	/v2/team/{team_id}/user
UpdateComment	send	PUT	/v2/comment/{comment_id}
DeleteChecklist	delete	DELETE	/v2/checklist/{checklist_id}
DeleteChecklistItem	delete	DELETE	/v2/checklist/{checklist_id}/checklist_item/{checklist_item_id}
DeleteComment	delete	DELETE	/v2/comment/{comment_id}
DeleteDependency	delete	DELETE	/v2/task/{task_id}/dependency
DeleteFolder	delete	DELETE	/v2/folder/{folder_id}
DeleteGoal	delete	DELETE	/v2/goal/{goal_id}
DeleteKeyResult	admin, delete	DELETE	/v2/key_result/{key_result_id}
DeleteList	delete	DELETE	/v2/list/{list_id}
DeleteSpace	delete	DELETE	/v2/space/{space_id}
DeleteSpaceTag	delete	DELETE	/v2/space/{space_id}/tag/{tag_name}
DeleteTask	delete	DELETE	/v2/task/{task_id}
DeleteTaskLink	delete	DELETE	/v2/task/{task_id}/link/{links_to}
DeleteTeam	admin, delete	DELETE	/v2/group/{group_id}
DeleteView	delete	DELETE	/v2/view/{view_id}
CreateGoal	admin, write	POST	/v2/team/{team_id}/goal
CreateKeyResult	admin, write	POST	/v2/goal/{goal_id}/key_result
CreateSpace	admin, write	POST	/v2/team/{team_id}/space
CreateTeamView	admin, write	POST	/v2/team/{team_id}/view
CreateUserGroup	admin, write	POST	/v2/team/{team_id}/group
AddDependency	write	POST	/v2/task/{task_id}/dependency
AddGuestToTask	write	POST	/v2/task/{task_id}/guest/{guest_id}
AddTagToTask	write	POST	/v2/task/{task_id}/tag/{tag_name}
AddTaskLink	write	POST	/v2/task/{task_id}/link/{links_to}
AddTaskToList	write	POST	/v2/list/{list_id}/task/{task_id}
CreateChecklist	write	POST	/v2/task/{task_id}/checklist
CreateChecklistItem	write	POST	/v2/checklist/{checklist_id}/checklist_item
CreateFolder	write	POST	/v2/space/{space_id}/folder
GetChatViewComments	read	GET	/v2/view/{view_id}/comment
GetCustomItems	read	GET	/v2/team/{team_id}/custom_item
GetFilteredTeamTasks	read	GET	/v2/team/{team_Id}/task
GetListComments	read	GET	/v2/list/{list_id}/comment
GetTask	read	GET	/v2/task/{task_id}
GetTask'sTimeinStatus	read	GET	/v2/task/{task_id}/time_in_status