Skip to navigation

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

typeenumOptional

Return only Lists (static_list) or only Views (dynamic_view).

Allowed values:

Response

OK
collectionlist of objects
paginationobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error