Objects

Get an appointment

Retrieve a single appointment by appointment ID.

Overview

Use this endpoint to read one appointment record. It requires public api oauth access token authentication and the crm.appointments.read scope.

GET/api/crm/objects/appointments/{appointmentId}

cURL

GET

bash

curl --request GET \  --url 'https://crm.notifyy.io/api/crm/objects/appointments/55?properties=name%2Cappointment_start_ts%2Cappointment_end_ts%2Cpipeline%2Cstage&associations=contact' \  --header 'Authorization: Bearer nfy_public_api_access_token'

Authorization

Public API OAuth access token

crm.appointments.read

Sample Request Body

This endpoint does not require a request body.

Sample Response

json

{  "success": true,  "message": "Appointment retrieved successfully",  "data": {    "id": 55,    "properties": {      "name": "Demo call",      "appointment_start_ts": "2026-08-01T10:00:00Z",      "appointment_end_ts": "2026-08-01T10:30:00Z",      "pipeline": "default_pipeline",      "stage": "scheduled"    },    "associations": {      "contact": [        {          "id": "456",          "type": "appointment_to_contact"        }      ]    }  }}

Status Codes

Code	Description
200	Appointment was returned.

Headers

AuthorizationstringRequired

Public API OAuth bearer token.

Example: Bearer nfy_public_api_access_token

Object	Description
Authorization string	RequiredPublic API OAuth bearer token. Example: Bearer nfy_public_api_access_token

Path parameters

appointmentIdintegerRequired

Appointment ID.

Example: 55

Object	Description
appointmentId integer	RequiredAppointment ID. Example: 55

Query parameters

propertiesstringOptional

Comma-separated property internal names to return.

Example: name,appointment_start_ts,appointment_end_ts,pipeline,stage

associationsstringOptional

Comma-separated associated object types to include.

Example: contact

Object	Description
properties string	OptionalComma-separated property internal names to return. Example: name,appointment_start_ts,appointment_end_ts,pipeline,stage
associations string	OptionalComma-separated associated object types to include. Example: contact

Response fields

data.idinteger

Appointment record ID.

data.propertiesobject

Requested appointment properties keyed by internal name.

Object	Description
data.id integer	Appointment record ID.
data.properties object	Requested appointment properties keyed by internal name.