Clickup

clickup Authorization API

Operations for retrieving authenticated user information.

GitHub OpenAPI

Operations 1

GET /user Get authorized user #

Documentation

📖
Documentation
https://developer.clickup.com/docs/tasks
📖
Documentation
https://developer.clickup.com/reference/get-spaces
📖
Documentation
https://developer.clickup.com/reference/get-lists
📖
Documentation
https://developer.clickup.com/reference/get-folders
📖
Documentation
https://developer.clickup.com/reference/get-goals
📖
Documentation
https://developer.clickup.com/reference/get-task-comments
📖
Documentation
https://developer.clickup.com/reference/get-teams
📖
Documentation
https://developer.clickup.com/docs/webhooks
📖
Documentation
https://developer.clickup.com/reference/get-accessible-custom-fields
📖
Documentation
https://developer.clickup.com/reference/get-time-entries-within-a-date-range
📖
Documentation
https://developer.clickup.com/reference/get-views
📖
Documentation
https://developer.clickup.com/docs/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-authorization-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/asyncapi/clickup-webhooks-asyncapi.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/graphql/clickup-graphql.md
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clickup-authorization-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickup-authorization-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ClickUp Comments Authorization API
  description: The ClickUp Comments API provides endpoints for creating and retrieving comments on tasks, views, and lists. Comments support rich text formatting, mentions, and attachments. Developers can use this API to build integrations that synchronize discussions between ClickUp and other collaboration tools, or to programmatically add status updates and notes to tasks.
  version: '2.0'
  contact:
    name: ClickUp Support
    url: https://help.clickup.com
  termsOfService: https://clickup.com/terms
servers:
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
security:
- bearerAuth: []
tags:
- name: Authorization
  description: Operations for retrieving authenticated user information.
paths:
  /user:
    get:
      operationId: getAuthorizedUser
      summary: Get authorized user
      description: Retrieves information about the currently authenticated user, including their ID, username, email, and profile picture. This endpoint requires a valid access token.
      tags:
      - Authorization
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Successfully retrieved user information
          content:
            application/json:
              schema:
                type: object
                properties:
                  user:
                    $ref: '#/components/schemas/AuthorizedUser'
        '401':
          description: Unauthorized - invalid or expired token
components:
  schemas:
    AuthorizedUser:
      type: object
      description: The authenticated user's profile information.
      properties:
        id:
          type: integer
          description: The unique identifier of the user.
        username:
          type: string
          description: The username of the user.
        email:
          type: string
          format: email
          description: The email address of the user.
        color:
          type: string
          description: The hex color code associated with the user.
        profilePicture:
          type: string
          format: uri
          nullable: true
          description: URL of the user's profile picture.
        initials:
          type: string
          description: The initials of the user.
        week_start_day:
          type: integer
          description: The day of the week that starts the user's week. 0 is Sunday.
        global_font_support:
          type: boolean
          description: Whether global font support is enabled.
        timezone:
          type: string
          description: The user's timezone.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: ClickUp personal API token or OAuth access token.
externalDocs:
  description: ClickUp Comments API Documentation
  url: https://developer.clickup.com/reference/get-task-comments