Get Contact Custom Field Definition | Calendly

const url = 'https://api.calendly.com/contacts/custom_field_definitions/uuid';
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);
}

{
  "resource": {
    "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 a single custom field definition by uuid.

Required scopes

contacts:read

Returns a single custom field definition by uuid. <Info title="Required scopes"> > `contacts:read` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Path parameters

uuidstringRequired

Response

resourceobject

A custom field definition describes the schema for a field that can be applied to Contacts.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error