Skip to main content

​
Create Calendar Event

curl -X POST https://api.kinconecta.com/api/guide_calendar_events \
  -H "Content-Type: application/json" \
  -d '{
    "guideId": 789,
    "eventType": "BOOKED",
    "title": "City Walking Tour",
    "startDatetime": "2026-04-15T10:00:00",
    "endDatetime": "2026-04-15T14:00:00",
    "organizerName": "John Doe",
    "source": "TRIP",
    "status": "ACTIVE"
  }'
Create a new calendar event for a guide.

​
Request Body

​
guideId
integer
required
ID of the guide
​
tripId
integer
ID of the trip booking (if event is linked to a trip)
​
eventType
enum
required
Type of calendar event
  • BOOKED: Time is booked for a tour
  • BLOCKED: Time is blocked and unavailable
​
title
string
required
Event title
​
startDatetime
datetime
required
Event start date and time
​
endDatetime
datetime
required
Event end date and time
​
organizerName
string
Name of the event organizer
​
source
enum
required
Source of the calendar event
  • MANUAL: Manually created by guide
  • GOOGLE: Synced from Google Calendar
  • TRIP: Automatically created from trip booking
​
status
enum
required
Event status
  • ACTIVE: Event is active
  • CANCELLED: Event is cancelled

​
Response

​
eventId
integer
Unique identifier for the calendar event
​
guideId
integer
ID of the guide
​
tripId
integer
ID of the trip booking
​
eventType
enum
Event type (BOOKED, BLOCKED)
​
title
string
Event title
​
startDatetime
datetime
Event start date and time
​
endDatetime
datetime
Event end date and time
​
organizerName
string
Name of the organizer
​
source
enum
Event source (MANUAL, GOOGLE, TRIP)
​
status
enum
Event status (ACTIVE, CANCELLED)
​
createdAt
datetime
Timestamp when the event was created

​
Get All Calendar Events

curl https://api.kinconecta.com/api/guide_calendar_events
Retrieve all calendar events in the system.

​
Response

Returns an array of calendar event objects.

​
Get Calendar Event by ID

curl https://api.kinconecta.com/api/guide_calendar_events/123
Retrieve a specific calendar event by its ID.

​
Path Parameters

​
id
integer
required
The event ID

​
Response

Returns a single calendar event object.

​
Update Calendar Event

curl -X PUT https://api.kinconecta.com/api/guide_calendar_events/123 \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Extended City Walking Tour",
    "endDatetime": "2026-04-15T16:00:00",
    "status": "ACTIVE"
  }'
Update an existing calendar event.

​
Path Parameters

​
id
integer
required
The event ID

​
Request Body

All fields from the create request are optional. Only provide the fields you want to update.

​
Response

Returns the updated calendar event object.

​
Delete Calendar Event

curl -X DELETE https://api.kinconecta.com/api/guide_calendar_events/123
Delete a calendar event by its ID.

​
Path Parameters

​
id
integer
required
The event ID

​
Response

Returns 204 No Content on successful deletion.

Build docs developers (and LLMs) love

Get started for freeTalk to us