Skip to main content

Create Event

Controlled node

Overview

Creates a new event in Google Calendar with specified details including title, description, timing, attendees, and recurrence patterns. This node integrates with Google Calendar to allow automated event creation within your workflows.

Recurrence Options

The node supports several recurrence patterns for repeating events:

OptionDescription
Does not repeatSingle occurrence event
DailyRepeats every day
Every weekdayRepeats Monday through Friday only
WeeklyRepeats weekly on the same day
MonthlyRepeats monthly on the same date
YearlyRepeats annually on the same date

Attendee Formats

Attendees can be provided in multiple formats:

  • Comma-separated string: "email1@example.com, email2@example.com"
  • Single email string: "email@example.com"
  • Array of emails: ["email1@example.com", "email2@example.com"]
  • Array of objects: [{email: "email@example.com", displayName: "John Doe"}]
Timezone Handling

The node automatically strips timezone suffixes (Z or +00:00) from ISO datetime strings to treat them as local time in the specified timezone. For example, 2025-11-14T11:00:00Z becomes 2025-11-14T11:00:00 in the specified timezone.

Inputs

InputTypeDescriptionDefault
RunEventTriggers the node to create the calendar event-
SummaryTextThe title of the event-
DescriptionPlainTextDetailed description of the event-
LocationTextPhysical location or address for the event-
Start DateTimeDateTimeStart time of the event (ISO format)-
End DateTimeDateTimeEnd time of the event (ISO format)-
Time ZoneTimeZoneTimezone for the event (e.g., 'America/New_York', 'UTC')System default timezone
RecurrenceEnumRecurrence pattern: NO_REPEAT, DAILY, WEEKDAY, WEEKLY, MONTHLY, YEARLYNO_REPEAT
AttendeesTextList of attendee emails (comma-separated, array, or objects)-
Calendar IDTextTarget calendar ID (use 'primary' for main calendar)primary
Send UpdatesEnumNotification setting: 'all' (notify all attendees) or 'externalOnly' (notify external only)all
ConferenceBooleanWhether to automatically add a Google Meet conference linktrue
ConnectionsConnectionGoogle Calendar connection credentials-

Outputs

OutputTypeDescription
DoneEventFires when the event has been successfully created
ResultDataThe created event object containing event ID, links, and metadata

Runtime Behavior and Defaults

This is a controlled node that executes when triggered by the Run event. It requires a valid Google Calendar connection to authenticate API requests.

Default Values:

  • Time Zone: Defaults to the system's local timezone (e.g., 'America/New_York')
  • Calendar ID: Defaults to 'primary' (the user's main calendar)
  • Send Updates: Defaults to 'all' (sends notifications to all attendees)
  • Conference: Defaults to true (automatically creates a Google Meet link)
  • Recurrence: Defaults to 'NO_REPEAT' (non-recurring event)

Validation:

  • The Summary field is required. If missing, the node returns an error.
  • Both Start DateTime and End DateTime are required and must be valid datetime strings.

Attendee Processing:

  • Strings containing commas are split into individual email addresses
  • Single strings are treated as one attendee
  • Arrays are processed element by element
  • Objects are passed through with email/displayName properties preserved

Recurrence Handling: When a recurrence option other than "Does not repeat" is selected, the node generates an RRULE (Recurrence Rule) string in the format RRULE:FREQ=DAILY, RRULE:FREQ=WEEKLY, etc., which Google Calendar uses to create the repeating event pattern.

Example Usage

Here's an example of creating a weekly team meeting with attendees:

  1. Connect a Start node or trigger event to the Run input
  2. Provide the meeting details:
    • Summary: "Weekly Team Standup"
    • Description: "Regular team sync to discuss progress and blockers"
    • Location: "Conference Room A" (or leave blank for virtual-only)
    • Start DateTime: "2025-01-15T10:00:00" (10:00 AM local time)
    • End DateTime: "2025-01-15T10:30:00" (30 minutes later)
    • Time Zone: "America/New_York"
    • Recurrence: "Weekly"
    • Attendees: "alice@example.com, bob@example.com, carol@example.com"
    • Conference: true (adds Google Meet link automatically)
  3. Connect the Done event to trigger follow-up actions (like sending confirmation emails)
  4. Use the Result output to capture the created event ID for later reference (e.g., to update or delete the event)

The node will create the event in the specified calendar and return the full event object through the Result output, including the event ID, calendar links, and any generated conference details.