Calendar Events

Schedule and manage meetings, calls, and events linked to leads, accounts, or opportunities.

GET/calendar/events

List calendar events with date range and entity filters.

Parameter	Type	Description
startDate	string	ISO 8601 datetime
endDate	string	ISO 8601 datetime
entityType	string	Filter: lead, account, opportunity
entityId	uuid	UUID of the linked entity
limit	int	Max results (default: 100, max: 500)
offset	int	Pagination offset (default: 0)

startDate(string)

ISO 8601 datetime

endDate(string)

ISO 8601 datetime

entityType(string)

Filter: lead, account, opportunity

entityId(uuid)

UUID of the linked entity

limit(int)

Max results (default: 100, max: 500)

offset(int)

Pagination offset (default: 0)

Request

curl "https://kashew.ai/api/v1/calendar/events?startDate=2026-04-01T00:00:00Z&endDate=2026-04-30T23:59:59Z" \
  -H "Authorization: Bearer kshw_YOUR_KEY"

200Response

{
  "success": true,
  "events": [{
    "id": "uuid",
    "title": "Client Meeting",
    "description": "Quarterly review",
    "start_time": "2026-04-15T10:00:00",
    "end_time": "2026-04-15T11:00:00",
    "location": "Zoom",
    "is_all_day": false,
    "attendees": ["alice@acme.com"],
    "entity_type": "account",
    "entity_id": "uuid"
  }],
  "count": 12
}

POST/calendar/events

Create a new calendar event linked to a CRM entity.

Request Body

{
  "title": "Client Meeting",
  "startTime": "2026-04-15T10:00:00Z",
  "endTime": "2026-04-15T11:00:00Z",
  "description": "Quarterly business review",
  "location": "Zoom",
  "timezone": "UTC",
  "isAllDay": false,
  "attendees": ["alice@acme.com", "bob@acme.com"],
  "entityType": "account",
  "entityId": "uuid-of-account"
}

Fields

Field	Required	Description
title	yes	Event title
startTime	yes	ISO 8601 datetime
endTime	yes	ISO 8601 datetime
entityType	yes	lead, account, opportunity
entityId	yes	UUID of linked entity
description	no	Agenda or purpose
location	no	Zoom link, office address, etc.
attendees	no	Array of email addresses
timezone	no	e.g. "UTC", "America/New_York"
isAllDay	no	Default false

201Response

{ "id": "uuid", "status": "created", "success": true }

PUT/calendar/events/:id

Update an event's title, time, description, or attendees.

Request

curl -X PUT "https://kashew.ai/api/v1/calendar/events/uuid-..." \
  -H "Authorization: Bearer kshw_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Updated Meeting Title", "description": "New agenda"}'