List Contact Custom Field Definitions | Calendly

const url = 'https://api.calendly.com/contacts/custom_field_definitions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "collection": [
    {
      "uri": "https://api.calendly.com/contacts/custom_field_definitions/CCCCCCCCCCCCCCCC",
      "label": "Meeting prep notes",
      "field_type": "invitee_question",
      "created_at": "2026-06-03T20:52:43Z",
      "updated_at": "2026-06-03T20:52:43Z",
      "source": {
        "type": "event_type_invitee_question",
        "event_type_uri": "https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA",
        "question": "Please share anything that will help prepare for our meeting."
      }
    }
  ]
}

Returns all custom field definitions available to the authenticated user or organization.

Required scopes

contacts:read

Returns all custom field definitions available to the authenticated user or organization. <Info title="Required scopes"> > `contacts:read` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Response

collectionlist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error