> Calendly developer docs. For page Markdown, append .md to any URL. > Index: https://developer.calendly.com/llms.txt > API catalog: https://developer.calendly.com/.well-known/api-catalog > OpenAPI: https://developer.calendly.com/openapi/calendly-api.yaml > OAuth authorization server: https://calendly.com/.well-known/oauth-authorization-server > MCP protected resource: https://mcp.calendly.com/.well-known/oauth-protected-resource > Scheduling MCP endpoint: https://mcp.calendly.com > Docs search MCP: https://developer.calendly.com/_mcp/server # List Event Type Hosts GET https://api.calendly.com/event_type_memberships Fetch list of event type hosts > `event_types:read` Reference: https://developer.calendly.com/api-docs/calendly-api/event-types/list-event-type-memberships ## Authentication - `Authorization` header (bearer token, required) — Personal Access Token - `Authorization` header (bearer token, required) — OAuth 2.0 ## Request ### Query parameters - `event_type` (string, required) — The uri associated with the event type - `count` (integer, optional, default: 20) — The number of rows to return - `page_token` (string, optional) — The token to pass to get the next or previous portion of the collection ## Response ### 200 OK - `collection` (list of EventTypeMembershipsGetResponsesContentApplicationJsonSchemaCollectionItems, required) — The set of hosts for a given event type - `pagination` (Pagination, required) ## Errors ### 400 Bad Request Error Request is not valid - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 401 Unauthorized Error Cannot authenticate caller - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 403 Forbidden Error Permission denied or insufficient scope - `List-event-type-membershipsRequestForbiddenError` ### 404 Not Found Error Requested resource not found - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 500 Internal Server Error An error has occurred on the server - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ## Types ### EventTypeMembershipsGetResponsesContentApplicationJsonSchemaCollectionItems - `uri` (string, required) — Canonical reference (unique identifier) for the event type membership - `event_type` (EventType, required) — A configuration for an Event Type - `member` (User, optional) — The event type host - `updated_at` (string, optional) — Date and time of last update - `created_at` (string, optional) — Date and time of creation ### Pagination - `count` (integer, required) — The number of rows to return - `next_page` (string, required, nullable) — URI to return the next page of an ordered list ("null" indicates no additional results are available) - `previous_page` (string, required, nullable) — URI to return the previous page of an ordered list ("null" indicates no additional results are available) - `next_page_token` (string, required, nullable) — Token to return the next page of an ordered list ("null" indicates no additional results are available) - `previous_page_token` (string, required, nullable) — Token to return the previous page of an ordered list ("null" indicates no additional results are available) ### ErrorResponseDetailsItem - `message` (string, required) - `parameter` (string, optional) - `code` (string, optional) ### ListEventTypeMembershipsRequestForbiddenError0 Error Object - `title` (enum, required) - Allowed values: `Permission Denied` - `message` (enum, required) - Allowed values: `You do not have permission to access this resource.`, `You do not have permission` - `details` (list of ErrorResponseDetailsItem, optional) ### InsufficientScopeError Caller does not have required oauth scopes - `title` (enum, required) - Allowed values: `Insufficient scope` - `message` (enum, required) - Allowed values: `This operation requires the scopes listed in the 'required_scopes' array.` - `required_scopes` (list of string, required) ### EventType A configuration for an Event Type - `active` (boolean, required) — Indicates if the event is active or not. - `admin_managed` (boolean, required) — Indicates if this event type is managed by an organization admin - `booking_method` (enum, required) — Indicates if the event type is for a poll or an instant booking - Allowed values: `instant`, `poll` - `color` (string, required) — The hexadecimal color value of the event type's scheduling page - `created_at` (string, required) — The moment the event type was created (e.g. "2020-01-02T03:04:05.678123Z") - `custom_questions` (list of EventTypeCustomQuestion, required) - `deleted_at` (string, required, nullable) — The moment the event type was deleted (e.g. "2020-01-02T03:04:05.678123Z"). Since event types can be deleted but their scheduled events remain it's useful to fetch a deleted event type when you still require event type data for a scheduled event. - `description_html` (string, required, nullable) — The event type's description (formatted with HTML) - `description_plain` (string, required, nullable) — The event type's description (in non formatted text) - `duration` (double, required) — The length of sessions booked with this event type - `duration_options` (list of integer, required, nullable) — Array of duration options. Always null for adhoc event types. - `internal_note` (string, required, nullable) — Contents of a note that may be associated with the event type - `is_paid` (boolean, required) - `kind` (enum, required) — Indicates if the event type is "solo" (belongs to an individual user) or "group" - Allowed values: `solo`, `group` - `locale` (enum, required) — The locale on the event type, used to determine the language of the event type's scheduling page - Allowed values: `en`, `fr`, `es`, `de`, `nl`, `pt`, `it`, `uk` - `locations` (list of LocationConfiguration, required, nullable) — Configuration information for each possible location for this Event Type - `name` (string, required, nullable) — The event type name (in human-readable format) - `pooling_type` (enum, required, nullable) — Indicates if the event type is "round robin" (alternates between hosts) or "collective" (invitees pick a time when all participants are available) or “multi-pool” (considers availability delineated by pools of participants) or "null" (the event type doesn’t consider the availability of a group participants) - Allowed values: `round_robin`, `collective`, `multi_pool` - `position` (integer, required) — Position order of Event Type, starting with 0 (for display purposes) - `profile` (Profile, required) — The publicly visible profile of a User or a Team that's associated with the Event Type (note: some Event Types don't have profiles) - `scheduling_url` (string, required) — The URL of the user’s scheduling site where invitees book this event type - `secret` (boolean, required) — Indicates if the event type is hidden on the owner's main scheduling page - `slug` (string, required, nullable) — The portion of the event type's URL that identifies a specific web page (in a human-readable format) - `type` (enum, required) — Indicates if the event type is "AdhocEventType" (ad hoc event) or "StandardEventType" (standard event type) - Allowed values: `StandardEventType`, `AdhocEventType` - `updated_at` (string, required) — The moment the event type was last updated (e.g. "2020-01-02T03:04:05.678123Z") - `uri` (string, required) — Canonical reference (unique identifier) for the event type ### User Information about the user. - `uri` (string, required) — Canonical reference (unique identifier) for the user - `name` (string, required) — The user's name (human-readable format) - `slug` (string, required) — The portion of URL for the user's scheduling page (where invitees book sessions), rendered in a human-readable format - `email` (string, required) — The user's email address - `scheduling_url` (string, required) — The URL of the user's Calendly landing page (that lists all the user's event types) - `timezone` (string, required) — The time zone to use when presenting time to the user - `avatar_url` (string, required, nullable) — The URL of the user's avatar (image) - `created_at` (string, required) — The moment when the user's record was created (e.g. "2020-01-02T03:04:05.678123Z") - `updated_at` (string, required) — The moment when the user's record was last updated (e.g. "2020-01-02T03:04:05.678123Z") - `current_organization` (string, required) — A unique reference to the user's current organization - `resource_type` (string, required) — Resource type to support polymorphic associations. - `locale` (enum, required) — The user's language preference - Allowed values: `en`, `fr`, `es`, `de`, `pt`, `ps` - `time_notation` (enum, optional, default: 12h) — Time notation used by the user. Accepts "12h" or "24h" as a value. - Allowed values: `12h`, `24h` ### EventTypeCustomQuestion - `name` (string, required) — The custom question that the host created for the event type. - `type` (enum, required) — The type of response that the invitee provides to the custom question; can be one or multiple lines of text, a phone number, or single- or multiple-select. - Allowed values: `string`, `text`, `phone_number`, `single_select`, `multi_select` - `position` (integer, required) — The numerical position of the question on the event booking page after the name and email address fields. - `enabled` (boolean, required) — true if the question created by the host is turned ON and visible on the event booking page; false if turned OFF and invisible on the event booking page. - `required` (boolean, required) — true if a response to the question created by the host is required for invitees to book the event type; false if not required. - `answer_choices` (list of string, required) — The invitee’s option(s) for single_select or multi_select type of responses. - `include_other` (boolean, required) — true if the custom question lets invitees record a written response in addition to single-select or multiple-select type of responses; false if it doesn’t. ### LocationConfiguration A configuration for an EventType's location - `kind` (enum, optional) - Allowed values: `ask_invitee`, `custom`, `google_conference`, `gotomeeting_conference`, `inbound_call`, `microsoft_teams_conference`, `outbound_call`, `physical`, `webex_conference`, `zoom_conference` - `location` (string, optional) - `additional_info` (string, optional) - `phone_number` (string, optional) ### Profile The publicly visible profile of a User or a Team that's associated with the Event Type (note: some Event Types don't have profiles) - `type` (enum, required) — Indicates if the profile belongs to a "user" (individual) or "team" - Allowed values: `User`, `Team` - `name` (string, required) — Human-readable name for the profile of the user that's associated with the event type - `owner` (string, required) — The unique reference to the user associated with the profile ## Examples **Response** ```json { "collection": [ { "uri": "https://api.calendly.com/event_type_memberships/AAAAAAAAAAAAAAAA", "event_type": { "active": true, "admin_managed": true, "booking_method": "poll", "color": "#fff200", "created_at": "2019-01-02T03:04:05.678123Z", "custom_questions": [ { "name": "Company Name", "type": "string", "position": 0, "enabled": true, "required": true, "answer_choices": [], "include_other": true } ], "deleted_at": "2019-01-02T03:04:05.678123Z", "description_html": "

15 Minute Meeting

", "description_plain": "15 Minute Meeting", "duration": 15, "duration_options": [ 1, 13, 15, 720 ], "internal_note": "Internal note", "is_paid": false, "kind": "solo", "locale": "en", "locations": [ { "kind": "inbound_call", "additional_info": "Additional information about location", "phone_number": "+ 380934567654" } ], "name": "15 Minute Meeting", "pooling_type": "round_robin", "position": 0, "profile": { "type": "User", "name": "Tamara Jones", "owner": "https://api.calendly.com/users/AAAAAAAAAAAAAAAA" }, "scheduling_url": "https://calendly.com/acmesales", "secret": true, "slug": "acmesales", "type": "StandardEventType", "updated_at": "2019-08-07T06:05:04.321123Z", "uri": "https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA" }, "member": { "uri": "https://api.calendly.com/users/AAAAAAAAAAAAAAAA", "name": "John Doe", "slug": "acmesales", "email": "test@example.com", "scheduling_url": "https://calendly.com/acmesales", "timezone": "America/New York", "avatar_url": "https://01234567890.cloudfront.net/uploads/user/avatar/0123456/a1b2c3d4.png", "created_at": "2019-01-02T03:04:05.678123Z", "updated_at": "2019-08-07T06:05:04.321123Z", "current_organization": "https://api.calendly.com/organizations/AAAAAAAAAAAAAAAA", "resource_type": "User", "locale": "en", "time_notation": "12h" }, "updated_at": "2019-01-02T03:04:05.678123Z", "created_at": "2019-01-02T03:04:05.678123Z" } ], "pagination": { "count": 20, "next_page": "https://api.calendly.com/event_types?count=1&page_token=sNjq4TvMDfUHEl7zHRR0k0E1PCEJWvdi", "previous_page": "https://api.calendly.com/event_types?count=1&page_token=VJs2rfDYeY8ahZpq0QI1O114LJkNjd7H", "next_page_token": "sNjq4TvMDfUHEl7zHRR0k0E1PCEJWvdi", "previous_page_token": "VJs2rfDYeY8ahZpq0QI1O114LJkNjd7H" } } ``` **SDK Code** ```python Event Type Hosts import requests url = "https://api.calendly.com/event_type_memberships" querystring = {"event_type":"https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Event Type Hosts const url = 'https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Event Type Hosts package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Event Type Hosts require 'uri' require 'net/http' url = URI("https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Event Type Hosts import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA") .header("Authorization", "Bearer ") .asString(); ``` ```php Event Type Hosts request('GET', 'https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Event Type Hosts using RestSharp; var client = new RestClient("https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Event Type Hosts import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.calendly.com/event_type_memberships?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2FAAAAAAAAAAAAAAAA")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```