Calendly

Calendly Users API

Endpoints for retrieving user information and managing user accounts within Calendly.

GitHub OpenAPI

Operations 2

GET /users/me Get current user #
GET /users/{uuid} Get user #

Documentation

📖
Documentation
https://developer.calendly.com/api-docs

Specifications

⚙
OpenAPI
https://artifacts.apis.io/calendly/openapi/calendly-users-api-openapi.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/calendly:calendly-users-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

calendly-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Calendly Users API
  version: 1.0.0
servers:
- url: https://api.calendly.com
  description: https://api.calendly.com
tags:
- name: Users
paths:
  /users/me:
    get:
      operationId: users_get-current-user
      summary: Get current user
      description: 'Returns basic information about your user account.


        > `users:read`'
      tags:
      - Users
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/users_get-current-user_Response_200'
        '401':
          description: Cannot authenticate caller
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-current-userRequestUnauthorizedError'
        '403':
          description: Permission denied or insufficient scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-current-userRequestForbiddenError'
        '404':
          description: Requested resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-current-userRequestNotFoundError'
        '500':
          description: An error has occurred on the server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-current-userRequestInternalServerError'
      security:
      - oauth2: []
  /users/{uuid}:
    get:
      operationId: users_get-user
      summary: Get user
      description: 'Returns information about a specified User.


        > `users:read`'
      tags:
      - Users
      parameters:
      - name: uuid
        in: path
        description: User unique identifier, or the constant "me" to reference the caller
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/users_get-user_Response_200'
        '401':
          description: Cannot authenticate caller
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-userRequestUnauthorizedError'
        '403':
          description: Permission denied or insufficient scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-userRequestForbiddenError'
        '404':
          description: Requested resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-userRequestNotFoundError'
        '500':
          description: An error has occurred on the server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get-userRequestInternalServerError'
      security:
      - oauth2: []
components:
  schemas:
    InsufficientScopeErrorTitle:
      type: string
      enum:
      - Insufficient scope
      title: InsufficientScopeErrorTitle
    Get-userRequestInternalServerError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-userRequestInternalServerError
    InsufficientScopeError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/InsufficientScopeErrorTitle'
        message:
          $ref: '#/components/schemas/InsufficientScopeErrorMessage'
        required_scopes:
          type: array
          items:
            type: string
            pattern: ^[a-z_]+:(read|write)$
      required:
      - title
      - message
      - required_scopes
      description: Caller does not have required oauth scopes
      title: InsufficientScopeError
    users_get-user_Response_200:
      type: object
      properties:
        resource:
          $ref: '#/components/schemas/User'
      required:
      - resource
      description: Service response
      title: users_get-user_Response_200
    Get-current-userRequestInternalServerError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-current-userRequestInternalServerError
    UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Message:
      type: string
      enum:
      - You do not have permission to access this resource.
      - You do not have permission
      title: UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Message
    UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Message:
      type: string
      enum:
      - You do not have permission to access this resource.
      - You do not have permission
      title: UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Message
    UserTimeNotation:
      type: string
      enum:
      - 12h
      - 24h
      default: 12h
      description: Time notation used by the user. Accepts "12h" or "24h" as a value.
      title: UserTimeNotation
    UsersMeGetResponsesContentApplicationJsonSchemaMessage:
      type: string
      enum:
      - The server encountered an unexpected condition that prevented it from fulfilling the request.
      title: UsersMeGetResponsesContentApplicationJsonSchemaMessage
    User:
      type: object
      properties:
        uri:
          type: string
          format: uri
          description: Canonical reference (unique identifier) for the user
        name:
          type: string
          description: The user's name (human-readable format)
        slug:
          type: string
          description: The portion of URL for the user's scheduling page (where invitees book sessions), rendered in a human-readable format
        email:
          type: string
          format: email
          description: The user's email address
        scheduling_url:
          type: string
          format: uri
          description: The URL of the user's Calendly landing page (that lists all the user's event types)
        timezone:
          type: string
          description: The time zone to use when presenting time to the user
        time_notation:
          $ref: '#/components/schemas/UserTimeNotation'
          default: 12h
          description: Time notation used by the user. Accepts "12h" or "24h" as a value.
        avatar_url:
          type:
          - string
          - 'null'
          format: uri
          description: The URL of the user's avatar (image)
        created_at:
          type: string
          format: date-time
          description: The moment when the user's record was created (e.g. "2020-01-02T03:04:05.678123Z")
        updated_at:
          type: string
          format: date-time
          description: The moment when the user's record was last updated (e.g. "2020-01-02T03:04:05.678123Z")
        current_organization:
          type: string
          format: uri
          description: A unique reference to the user's current organization
        resource_type:
          type: string
          description: Resource type to support polymorphic associations.
        locale:
          $ref: '#/components/schemas/UserLocale'
          description: The user's language preference
      required:
      - uri
      - name
      - slug
      - email
      - scheduling_url
      - timezone
      - avatar_url
      - created_at
      - updated_at
      - current_organization
      - resource_type
      - locale
      description: Information about the user.
      title: User
    UsersUuidGetResponsesContentApplicationJsonSchemaTitle:
      type: string
      enum:
      - Internal Server Error
      title: UsersUuidGetResponsesContentApplicationJsonSchemaTitle
    InsufficientScopeErrorMessage:
      type: string
      enum:
      - This operation requires the scopes listed in the 'required_scopes' array.
      title: InsufficientScopeErrorMessage
    UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Title:
      type: string
      enum:
      - Permission Denied
      title: UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Title
    GetCurrentUserRequestForbiddenError0:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Title'
        message:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaOneOf0Message'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: GetCurrentUserRequestForbiddenError0
    UsersUuidGetResponsesContentApplicationJsonSchemaMessage:
      type: string
      enum:
      - The server encountered an unexpected condition that prevented it from fulfilling the request.
      title: UsersUuidGetResponsesContentApplicationJsonSchemaMessage
    GetUserRequestForbiddenError0:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Title'
        message:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Message'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: GetUserRequestForbiddenError0
    Get-userRequestForbiddenError:
      oneOf:
      - $ref: '#/components/schemas/GetUserRequestForbiddenError0'
      - $ref: '#/components/schemas/InsufficientScopeError'
      title: Get-userRequestForbiddenError
    Get-userRequestUnauthorizedError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-userRequestUnauthorizedError
    Get-current-userRequestUnauthorizedError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-current-userRequestUnauthorizedError
    Get-userRequestNotFoundError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersUuidGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-userRequestNotFoundError
    Get-current-userRequestNotFoundError:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaTitle'
        message:
          $ref: '#/components/schemas/UsersMeGetResponsesContentApplicationJsonSchemaMessage'
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseDetailsItem'
      required:
      - title
      - message
      description: Error Object
      title: Get-current-userRequestNotFoundError
    Get-current-userRequestForbiddenError:
      oneOf:
      - $ref: '#/components/schemas/GetCurrentUserRequestForbiddenError0'
      - $ref: '#/components/schemas/InsufficientScopeError'
      title: Get-current-userRequestForbiddenError
    users_get-current-user_Response_200:
      type: object
      properties:
        resource:
          $ref: '#/components/schemas/User'
      required:
      - resource
      description: Service response
      title: users_get-current-user_Response_200
    UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Title:
      type: string
      enum:
      - Permission Denied
      title: UsersUuidGetResponsesContentApplicationJsonSchemaOneOf0Title
    UserLocale:
      type: string
      enum:
      - en
      - fr
      - es
      - de
      - pt
      - ps
      description: The user's language preference
      title: UserLocale
    UsersMeGetResponsesContentApplicationJsonSchemaTitle:
      type: string
      enum:
      - Internal Server Error
      title: UsersMeGetResponsesContentApplicationJsonSchemaTitle
    ErrorResponseDetailsItem:
      type: object
      properties:
        parameter:
          type: string
        message:
          type: string
        code:
          type: string
      required:
      - message
      title: ErrorResponseDetailsItem
  securitySchemes:
    oauth2:
      type: http
      scheme: bearer
      description: OAuth 2.0
    personal_access_token:
      type: http
      scheme: bearer
      description: Personal Access Token
x-provenance:
  method: harvested
  publisher: Calendly
  source: https://developer.calendly.com/openapi/calendly-api.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)