Clickup

clickup Authorization API

Operations for retrieving authenticated user information.

Documentation GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/oauth/token Exchange an OAuth code for an access token · Get Access Token #

Ask an LLM

“How do I turn an OAuth authorization code into a ClickUp access token?”

“Do I need this token exchange if I'm using a personal API token?”

Tell an agent

Exchange code {code} for an access token using client {client_id} and secret {client_secret}.

Finish the OAuth flow for app {client_id} with secret {client_secret} and authorization code {code}.

GET /v2/user Get the authenticated user's account (v2) · Get Authorized User #

Ask an LLM

“Which account is my token authenticated as, via the v2 endpoint?”

“How do I check the v2 details of the user behind my API token?”

Tell an agent

Via v2, show the account details of the authorized user.

Using v2, tell me who I'm authenticated as.

GET /user Get the current user's profile (unversioned) · Get authorized user #

Ask an LLM

“Which non-v2 endpoint returns my user ID, username, email and profile picture?”

“Can I read the current user's profile from the unversioned path?”

Tell an agent

On the unversioned path, get my user ID, username and email.

Using the non-v2 endpoint, fetch the current user's profile picture and username.

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: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

openapi: 3.2.0
info:
  title: Clickup Authorization API
  version: '2.0'
  description: 'Operations tagged Authorization across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-oauth-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
tags:
- name: Authorization
paths:
  /v2/oauth/token:
    parameters: []
    post:
      summary: Get Access Token
      tags:
      - Authorization
      description: 'These are the routes for authing the API and going through the OAuth flow.\

        \

        Applications utilizing a personal API token don''t use this endpoint.\

        \

        ***Note:** OAuth tokens are not supported when using the **Try It** feature of our Reference docs. You can''t try this endpoint from your web browser.*'
      operationId: GetAccessToken
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: GetAccessTokenrequest
              required:
              - client_id
              - client_secret
              - code
              type: object
              properties:
                client_id:
                  type: string
                  description: OAuth app client id
                client_secret:
                  type: string
                  description: OAuth app client secret
                code:
                  type: string
                  description: Code given in redirect url
              examples:
              - client_id: your_client_id
                client_secret: your_client_secret
                code: authorization_code
            example:
              client_id: your_client_id
              client_secret: your_client_secret
              code: authorization_code
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/paths/~1v2~1oauth~1token/post/requestBody/content/application~1json/schema'
            example:
              client_id: your_client_id
              client_secret: your_client_secret
              code: authorization_code
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: GetAccessTokenresponse
                required:
                - access_token
                type: object
                properties:
                  access_token:
                    type: string
                examples:
                - access_token: access token
              example:
                access_token: access token
      deprecated: false
      security: []
      x-hideTryItPanel: true
    servers:
    - url: https://api.clickup.com/api
      description: ClickUp
      variables: {}
  /v2/user:
    parameters: []
    get:
      summary: Get Authorized User
      tags:
      - Authorization
      description: View the details of the authenticated user's ClickUp account.
      operationId: GetAuthorizedUser
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: GetAuthorizedUserresponse
                type: object
                properties:
                  user:
                    title: User
                    type: object
                    properties:
                      id:
                        type: integer
                        contentEncoding: int32
                      username:
                        type: string
                      email:
                        type: string
                      color:
                        type: string
                      profilePicture:
                        type: string
                      initials:
                        type: string
                      week_start_day:
                        type: integer
                        contentEncoding: int32
                        description: The user's preferred start of the calendar week setting. \ `0` is Sunday. \ `1` is Monday.
                      global_font_support:
                        type: boolean
                      timezeone:
                        type: string
                    examples:
                    - id: 123
                      username: John Doe
                      email: user@company.com
                      color: '#000000'
                      profilePicture: https://clickup.com/avatar.jpg
                      initials: JD
                      week_start_day: 0
                      global_font_support: false
                      timezone: America/Los_Angeles
                examples:
                - user:
                    id: 123
                    username: John Doe
                    email: user@company.com
                    color: '#000000'
                    profilePicture: https://clickup.com/avatar.jpg
                    initials: JD
                    week_start_day: 0
                    global_font_support: false
                    timezone: America/Los_Angeles
              example:
                user:
                  id: 123
                  username: John Doe
                  email: user@company.com
                  color: '#000000'
                  profilePicture: https://clickup.com/avatar.jpg
                  initials: JD
                  week_start_day: 0
                  global_font_support: false
                  timezone: America/Los_Angeles
      deprecated: false
      security:
      - Authorization_Token: []
    servers:
    - url: https://api.clickup.com/api
      description: ClickUp
      variables: {}
  /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
    servers:
    - url: https://api.clickup.com/api/v2
      description: ClickUp API v2 Production Server
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:
    Authorization_Token:
      name: Authorization
      type: apiKey
      in: header
      description: 'API token required for authentication. Two types of tokens are supported:

        **Personal API Key** Obtain from ClickUp''s settings page under ''Apps'' and add it to the header as `Authorization: pk_...`

        **OAuth2 Access Token** Generated through the OAuth2 flow and add it to the header as `Authorization: Bearer {access_token}`'
    bearerAuth:
      type: http
      scheme: bearer
      description: ClickUp OAuth access token or personal API token. Include in the Authorization header as Bearer {token}.
externalDocs:
  description: ClickUp OAuth Documentation
  url: https://developer.clickup.com/docs/authentication
x-refined-from:
- clickup-api-v2-reference-openapi.json
- clickup-oauth-openapi.yml

clickup Authorization API

Operations 3

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification