List Contact Custom Field Definitions

GET

https://api.calendly.com/contacts/custom_field_definitions

GET

/contacts/custom_field_definitions

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

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