Get specific calendar event by ID (Admin)

Retrieve a specific calendar event by its ID. Requires admin authentication.

GET

https://api.channelautomation.com/api/calendar/events/{id}

Authorization

BearerAuth
optional
HTTP Bearer (JWT)

ApiKeyAuth
optional
API key in header

Path parameters

id
string
required
Calendar event ID

Returns

200

Event retrieved successfully

JSON

success
optional
boolean
event
optional
object
- workspace_id
  string
  required
  Workspace ID
- start_time
  string
  required
  Start time of the appointment
  
  format: date-time
- end_time
  string
  required
  End time of the appointment
  
  format: date-time
- id
  optional
  string
  Unique identifier (for updates)
- contact_id
  optional
  string
  Associated contact ID
- admin_id
  optional
  string
  Admin/agent ID
- event_title
  optional
  string
  Title of the event/appointment
- event_description
  optional
  string
  Description of the event
- status
  optional
  string
  Status of the appointment
- location
  optional
  string
  Location of the appointment
- notes
  optional
  string
  Additional notes
}

401

Authentication required

JSON

error
optional
string
success
optional
boolean

403

Admin privileges required

JSON

error
optional
string
success
optional
boolean

404

Event not found

JSON

success
optional
boolean
error
optional
string

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

Get specific calendar event by ID (Admin)

curl --request GET \
  --url https://api.channelautomation.com/api/calendar/events/1dfc54fd-cbc3-4483-858f-c0fb76f89328 \
  --header 'Authorization: Bearer <token>'

const url = 'https://api.channelautomation.com/api/calendar/events/1dfc54fd-cbc3-4483-858f-c0fb76f89328';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/calendar/events/1dfc54fd-cbc3-4483-858f-c0fb76f89328"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

Response example

{
  "success": true,
  "event": {
    "id": "appointment-uuid",
    "contact_id": "contact-uuid",
    "admin_id": "admin-uuid",
    "workspace_id": "workspace-uuid",
    "event_title": "Product Consultation",
    "event_description": "Initial consultation meeting",
    "start_time": "2025-07-15T09:00:00Z",
    "end_time": "2025-07-15T10:00:00Z",
    "status": "scheduled",
    "location": "Virtual Meeting",
    "notes": "Customer interested in kitchen renovation"
  }
}

{
  "error": "Authentication required",
  "success": false
}

{
  "error": "Admin privileges required",
  "success": false
}

{
  "success": false,
  "error": "Event not found"
}

{
  "error": "Internal server error",
  "details": "string",
  "success": false
}