Skip to main content
A calendar event is a scheduled item on a calendar. Use calendar events when you need to read company meetings, holidays, payroll deadlines, or other schedule entries that appear on Plane’s shared calendar. When all_day is true, treat starts and ends as dates rather than times. A holiday should render as a full-day event, not as a midnight-to-midnight timed block.

​
Attributes

​
id
string
Unique identifier for the event, for example cale_K2mP9qR4xL7s.
​
object
string
The object type. Always calendar.event.
​
calendar
string
ID of the calendar the event belongs to.
​
title
string
Short title shown on the calendar.
​
description
string | null
Optional longer description of the event.
​
starts
string
Timestamp when the event starts.
​
ends
string
Timestamp when the event ends.
​
all_day
boolean
Whether the event spans the full day. When true, interpret starts and ends as dates rather than times.
​
subject
string | null
ID of the record this event projects, such as a worker, leave, or holiday. Null when the event has no linked record. Some subjects may not resolve to a public API resource.
​
metadata
object
Set of key-value pairs attached to the event.
​
created
string
Timestamp of when the event was created.
​
updated
string
Timestamp of when the event was last updated.