> 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

# November 17, 2026

## Contacts

You can now group contacts into Lists, write private notes about a contact, and create custom field definitions. You can also filter List Contacts by a List or View.

### New endpoints

* **GET /contact_lists** – List the Lists and Views that a user saved. Use the `type` parameter to return only `static_list` or only `dynamic_view` items.
* **POST /contact_lists** – Create a List and, optionally, add contacts to it. You cannot create a View with this endpoint.
* **GET /contact_lists/\{uuid}** – Retrieve one List or View.
* **PATCH /contact_lists/\{uuid}** – Rename a List or View. Only the name can change.
* **POST /contact_lists/\{uuid}/memberships** – Add up to 500 contacts to a List. This operation is idempotent.
* **POST /contact_lists/\{uuid}/memberships/removal** – Remove up to 500 contacts from a List. The contacts are not deleted.
* **GET /notes** – List the notes about 1 to 10 contacts. The `contact` parameter is required.
* **POST /notes** – Create a note about one contact. Send a `title`, a `body`, or both. Add a reminder with `remind_at`.
* **GET /notes/\{uuid}** – Retrieve one note.
* **POST /contacts/custom_field_definitions** – Create a custom field definition.

### Updated endpoints

* **GET /contacts** – Accepts the optional `contact_list` parameter. Send a contact list URI to return only the contacts in that List or View.

### Notes

* These endpoints use the existing `contacts:read` and `contacts:write` scopes.
* A note is private. You can read only the notes that you wrote. Notes that other users wrote about the same contact are not returned.
* A user can have at most 25 Lists and Views. Views that a CSV import creates count toward this limit, but the API does not return them.

## Availability

You can now create an availability schedule for a user and change an existing one.

### New endpoints

* **POST /user_availability_schedules** – Create an availability schedule for the authenticated user. Send exactly one `wday` rule for each day of the week.
* **PATCH /user_availability_schedules/\{uuid}** – Update the name, time zone, or rules of a schedule, or make it the default.

### Notes

* These endpoints use the existing `availability:write` scope. Its description is now "Create and update availability schedules for users and event types."
* `rules` replaces the full rule set. To change one weekday or one date, read the schedule with **GET /user_availability_schedules/\{uuid}**, edit it, and send all the rules back.