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

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

429

Too Many Requests Error

500

Internal Server Error