> 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 16, 2026

## Custom field option color schema correction

You can use the OpenAPI schema to generate client models that accept custom field options with no assigned color.

### Corrections

* **GET /contacts/custom_field_definitions** – Correct the option `color` schema. The previous schema marked `color` as optional and did not permit `null`. Each option includes `color`. The value is a string when a color is set and `null` when no color is set. The GET response mapping is unchanged.
* **GET /contacts/custom_field_definitions/\{uuid}** – Apply the same `color` schema correction to the single-definition response.

### Notes

* Action required: If your client model assumes `color` is always a string, update it to accept `null`. Clients that already handle `null` need no change.