Delete v2oauth clients

DELETE

oauth-clients

{clientId}

curl --request DELETE \
  --url https://api.cal.com/v2/oauth-clients/{clientId}

{
  "status": "success",
  "data": {
    "id": "clsx38nbl0001vkhlwin9fmt0",
    "name": "MyClient",
    "secret": "secretValue",
    "permissions": [
      "BOOKING_READ",
      "BOOKING_WRITE"
    ],
    "logo": "https://example.com/logo.png",
    "redirectUris": [
      "https://example.com/callback"
    ],
    "organizationId": 1,
    "createdAt": "2024-03-23T08:33:21.851Z",
    "areEmailsEnabled": true,
    "areDefaultEventTypesEnabled": true,
    "bookingRedirectUri": "https://example.com/booking-redirect",
    "bookingCancelRedirectUri": "https://example.com/booking-cancel",
    "bookingRescheduleRedirectUri": "https://example.com/booking-reschedule"
  }
}

Path Parameters

clientId

string

required

Response

200 - application/json

status

enum<string>

required

Available options:

success,

error

Example:

"success"

data

object

required

data.id

string

required

Example:

"clsx38nbl0001vkhlwin9fmt0"

data.name

string

required

Example:

"MyClient"

data.secret

string

required

Example:

"secretValue"

data.permissions

enum<string>[]

required

Array of permission keys like ["BOOKING_READ", "BOOKING_WRITE"]

Available options:

EVENT_TYPE_READ,

EVENT_TYPE_WRITE,

BOOKING_READ,

BOOKING_WRITE,

SCHEDULE_READ,

SCHEDULE_WRITE,

APPS_READ,

APPS_WRITE,

PROFILE_READ,

PROFILE_WRITE

Example:

["BOOKING_READ", "BOOKING_WRITE"]

data.redirectUris

string[]

required

Example:

["https://example.com/callback"]

data.organizationId

number

required

Example:

1

data.createdAt

string

required

Example:

"2024-03-23T08:33:21.851Z"

data.areEmailsEnabled

boolean

required

Example:

true

data.areDefaultEventTypesEnabled

boolean

required

If enabled, when creating a managed user the managed user will have 4 default event types: 30 and 60 minutes without Cal video, 30 and 60 minutes with Cal video. Leave this disabled if you want to create a managed user and then manually create event types for the user.

Example:

true

data.logo

object

Example:

"https://example.com/logo.png"

data.bookingRedirectUri

string

Example:

"https://example.com/booking-redirect"

data.bookingCancelRedirectUri

string

Example:

"https://example.com/booking-cancel"

data.bookingRescheduleRedirectUri

string

Example:

"https://example.com/booking-reschedule"

Was this page helpful?

Suggest edits Raise issue

Get v2oauth clients 1 Patch v2oauth clients

curl --request DELETE \
  --url https://api.cal.com/v2/oauth-clients/{clientId}

{
  "status": "success",
  "data": {
    "id": "clsx38nbl0001vkhlwin9fmt0",
    "name": "MyClient",
    "secret": "secretValue",
    "permissions": [
      "BOOKING_READ",
      "BOOKING_WRITE"
    ],
    "logo": "https://example.com/logo.png",
    "redirectUris": [
      "https://example.com/callback"
    ],
    "organizationId": 1,
    "createdAt": "2024-03-23T08:33:21.851Z",
    "areEmailsEnabled": true,
    "areDefaultEventTypesEnabled": true,
    "bookingRedirectUri": "https://example.com/booking-redirect",
    "bookingCancelRedirectUri": "https://example.com/booking-cancel",
    "bookingRescheduleRedirectUri": "https://example.com/booking-reschedule"
  }
}

Getting Started

Platform / Cal Provider

Platform / Managed Users

Platform / Webhooks

Orgs / Attributes

Orgs / Attributes / Options

Orgs / Delegation Credentials

Orgs / Event Types

Orgs / Memberships

Orgs / Orgs

Orgs / Schedules

Orgs / Teams

Orgs / Teams / Bookings

Orgs / Teams / Memberships

Orgs / Teams / Routing forms / Responses

Orgs / Teams / Schedules

Orgs / Users

Orgs / Users / OOO

Orgs / Webhooks

Api Keys

Bookings

Calendars

Conferencing

Destination Calendars

Event Types

Event Types / Webhooks

Me

OAuth Clients

Schedules

Selected Calendars

Slots

Stripe

Teams

Teams / Event Types

Teams / Memberships

Timezones

Webhooks

Path Parameters

Response