Platform / Managed Users
Get all managed users
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 / OOO
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Platform / Managed Users
Get all managed users
GET
/
v2
/
oauth-clients
/
{clientId}
/
users
curl --request GET \
--url https://api.cal.com/v2/oauth-clients/{clientId}/users{
"status": "success",
"data": [
{
"id": 1,
"email": "[email protected]",
"username": "alice",
"name": "alice",
"timeZone": "America/New_York",
"weekStart": "Sunday",
"createdDate": "2024-04-01T00:00:00.000Z",
"timeFormat": 12,
"defaultScheduleId": null,
"locale": "en",
"avatarUrl": "https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png"
}
]
}Path Parameters
Query Parameters
The number of items to return
The number of items to skip
Filter managed users by email. If you want to filter by multiple emails, separate them with a comma.
Response
200 - application/json
Available options:
success, error Example:
"success"
Example:
1
Example:
Example:
"alice"
Example:
"alice"
Example:
"America/New_York"
Example:
"Sunday"
Example:
"2024-04-01T00:00:00.000Z"
Example:
12
Example:
null
Available options:
ar, ca, de, es, eu, he, id, ja, lv, pl, ro, sr, th, vi, az, cs, el, es-419, fi, hr, it, km, nl, pt, ru, sv, tr, zh-CN, bg, da, en, et, fr, hu, iw, ko, no, pt-BR, sk, ta, uk, zh-TW Example:
"en"
URL of the user's avatar image
Example:
"https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png"
Was this page helpful?
curl --request GET \
--url https://api.cal.com/v2/oauth-clients/{clientId}/users{
"status": "success",
"data": [
{
"id": 1,
"email": "[email protected]",
"username": "alice",
"name": "alice",
"timeZone": "America/New_York",
"weekStart": "Sunday",
"createdDate": "2024-04-01T00:00:00.000Z",
"timeFormat": 12,
"defaultScheduleId": null,
"locale": "en",
"avatarUrl": "https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png"
}
]
}