Skip to content
MockFlow DevelopersGet an API key

Create a calendar with events for schedules, appointments, holidays, and event planning.

Updated 9 Nov 20262 min read

Send "type": "calendar".

Create a calendar with events for schedules, appointments, holidays, and event planning.

Also available as the MCP tool render_calendar. The same payload works through either surface.

Fields

data
eventsobject[]required

Array of calendar events. Use same color for all events.

Child attributes
idstringrequired

Unique event ID (e.g., event_1)

titlestringrequired

Event title

descriptionstring

Event description

startstringrequired

Start date/time in ISO 8601 format with Z suffix

endstring

End date/time. For timed events: same day as start. For all-day: equals start.

allDayboolean

True for all-day events

colorstring

Event color. Use one of: #4285f4, #ea4335, #fbbc04, #34a853, #ff6d01, #46bdc6, #7986cb, #8e24aa

locationstring

Event location

attendeesstring[]
remindersobject[]
recurrencestring

Recurrence rule or null

createdAtstring

ISO date string

settingsobjectrequired

Calendar settings

Child attributes
themestring

Defaults to default.

weekStartsOnenum<integer>

0 for Sunday, 1 for Monday. One of 0 or 1.

dateFormatenum<string>

One of MM/DD/YYYY or DD/MM/YYYY. Defaults to MM/DD/YYYY.

timeFormatenum<string>

One of 12h or 24h. Defaults to 12h.

highlightWeekendsboolean

Defaults to true.

showWeekNumbersboolean

Defaults to false.

Example

{
  "type": "calendar",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "description": "string",
        "start": "string",
        "end": "string",
        "allDay": false,
        "color": "string",
        "location": "string",
        "attendees": [
          "string"
        ]
      }
    ],
    "settings": {
      "theme": "default",
      "weekStartsOn": 0,
      "dateFormat": "MM/DD/YYYY",
      "timeFormat": "12h",
      "highlightWeekends": true,
      "showWeekNumbers": false
    }
  }
}

Add one record

POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.

Record fields

record
titlestringrequired
startstringrequired
endstring
allDayboolean
locationstring
keystring

Your own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.

{
  "record": {
    "title": "Q4 Launch Planning",
    "start": "2026-10-01T09:30:00Z",
    "end": "2026-10-01T09:30:00Z",
    "allDay": false,
    "location": "string",
    "key": "string"
  }
}
Was this page helpful?

Sign in to MockFlow

The same account you use in the app and on the API.

Forgot your password?
or
Continue with GoogleContinue with MicrosoftContinue with Apple