Actions44
- Appointment Actions
- Calendar Actions
- Contact Actions
- Custom Field Actions
- Custom Value Actions
- Email Campaign Actions
- Email Stats Actions
- Email Template Actions
- Invoice Actions
- Note Actions
- Opportunity Actions
- Pipeline Actions
- Tag Actions
- User Actions
- Workflow Actions
Appointment → Get by Contact
AI-generatedSummary
Retrieves appointments for a specific GoHighLevel contact within a location, supporting filtering by status, date range, and calendar, and sorting by start time, end time, or date added.
Inputs
- Location (required) — The sub-account/location to operate on. Loaded from your agency credential.
- Contact ID (required) — The GHL contact ID to fetch appointments for.
- Limit — Maximum number of appointments to return after sorting and filtering. Defaults to 50.
- Sort By — Field to sort results by. Defaults to 'Start Time'.
- Sort Order — Direction of sorting. Defaults to 'Ascending (oldest first)'.
- Filter by Status — Only return appointments with this status. Defaults to 'Any'.
- Start After — Only return appointments whose start time is on or after this date.
- Start Before — Only return appointments whose start time is on or before this date.
- Filter by Calendar ID — Only return appointments from this calendar. Loaded from the selected location.
Output shape
A list of appointment items
Each item represents an appointment record. The response is paginated; use the 'Limit' option to control the number of items returned.
Examples
Example 1: Fetch the next 10 upcoming appointments for a contact, sorted by start time in descending order.
Contact ID: 12345, Limit: 10, Sort By: Start Time, Sort Order: Descending
Example 2: Retrieve only confirmed appointments for a contact within a specific date range.
Contact ID: 12345, Filter by Status: Confirmed, Start After: 2023-01-01T00:00:00Z