Delete a user

DELETE

organizations

{orgId}

users

{userId}

curl --request DELETE \
  --url https://api.cal.com/v2/organizations/{orgId}/users/{userId}

{
  "status": "success",
  "data": {
    "id": 1,
    "username": "john_doe",
    "name": "John Doe",
    "email": "[email protected]",
    "emailVerified": "2022-01-01T00:00:00Z",
    "bio": "I am a software developer",
    "avatarUrl": "https://example.com/avatar.jpg",
    "timeZone": "America/New_York",
    "weekStart": "Monday",
    "appTheme": "light",
    "theme": "default",
    "defaultScheduleId": 1,
    "locale": "en-US",
    "timeFormat": 12,
    "hideBranding": false,
    "brandColor": "#ffffff",
    "darkBrandColor": "#000000",
    "allowDynamicBooking": true,
    "createdDate": "2022-01-01T00:00:00Z",
    "verified": true,
    "invitedTo": 1,
    "profile": {
      "id": 1,
      "organizationId": 1,
      "userId": 1,
      "username": "john_doe"
    }
  }
}

Path Parameters

orgId

number

required

userId

number

required

Response

200 - application/json

status

enum<string>

required

Available options:

success,

error

Example:

"success"

data

object

required

data.id

number

required

The ID of the user

Example:

1

data.email

string

required

The email of the user

Example:

"[email protected]"

data.timeZone

string

required

The time zone of the user

Example:

"America/New_York"

data.weekStart

string

required

The week start day of the user

Example:

"Monday"

data.hideBranding

boolean

required

Whether to hide branding for the user

Example:

false

data.createdDate

string

required

The date when the user was created

Example:

"2022-01-01T00:00:00Z"

data.profile

object

required

organization user profile, contains user data within the organizaton context

data.username

string | null

The username of the user

Example:

"john_doe"

data.name

string | null

The name of the user

Example:

"John Doe"

data.emailVerified

string | null

The date when the email was verified

Example:

"2022-01-01T00:00:00Z"

data.bio

string | null

The bio of the user

Example:

"I am a software developer"

data.avatarUrl

string | null

The URL of the user's avatar

Example:

"https://example.com/avatar.jpg"

data.appTheme

string | null

The app theme of the user

Example:

"light"

data.theme

string | null

The theme of the user

Example:

"default"

data.defaultScheduleId

number | null

The ID of the default schedule for the user

Example:

1

data.locale

string | null

The locale of the user

Example:

"en-US"

data.timeFormat

number | null

The time format of the user

Example:

12

data.brandColor

string | null

The brand color of the user

Example:

"#ffffff"

data.darkBrandColor

string | null

The dark brand color of the user

Example:

"#000000"

data.allowDynamicBooking

boolean | null

Whether dynamic booking is allowed for the user

Example:

true

data.verified

boolean | null

Whether the user is verified

Example:

true

data.invitedTo

number | null

The ID of the user who invited this user

Example:

1

Was this page helpful?

Suggest edits Raise issue

Create a user Update a user

curl --request DELETE \
  --url https://api.cal.com/v2/organizations/{orgId}/users/{userId}

{
  "status": "success",
  "data": {
    "id": 1,
    "username": "john_doe",
    "name": "John Doe",
    "email": "[email protected]",
    "emailVerified": "2022-01-01T00:00:00Z",
    "bio": "I am a software developer",
    "avatarUrl": "https://example.com/avatar.jpg",
    "timeZone": "America/New_York",
    "weekStart": "Monday",
    "appTheme": "light",
    "theme": "default",
    "defaultScheduleId": 1,
    "locale": "en-US",
    "timeFormat": 12,
    "hideBranding": false,
    "brandColor": "#ffffff",
    "darkBrandColor": "#000000",
    "allowDynamicBooking": true,
    "createdDate": "2022-01-01T00:00:00Z",
    "verified": true,
    "invitedTo": 1,
    "profile": {
      "id": 1,
      "organizationId": 1,
      "userId": 1,
      "username": "john_doe"
    }
  }
}

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