List Contact Lists
Returns the user’s saved contact groupings: Lists (static_list) and Views (dynamic_view). This endpoint returns contact lists, not contacts. To get the contacts in a List or View, use List Contacts with the contact_list filter.
All of the user’s Lists and Views come back in one response, without pages. A user can have at most 25 Lists and Views. pagination.count is the number of Lists and Views returned, and the other pagination fields are always null.
The order is the same as in the Calendly web app. Views that a CSV import creates are not returned, but they count toward the limit of 25 Lists and Views.
contact_count is set for every List. It is null for every View.
Required scopes
contacts:read
Authentication
AuthorizationBearer
OAuth 2.0
OR
AuthorizationBearer
Personal Access Token
Query parameters
type
Return only Lists (static_list) or only Views (dynamic_view).
Allowed values:
Response
OK
collection
pagination
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error