Дії Google

Створити подію в Calendar

Booking form → Calendar event

API Trigger receives a form payload, creates a calendar event with the booker as attendee

Event

API Trigger

body

Google

Create Calendar Event

summary
Booking with {{body.name}}
start
{{body.start}}
end
{{body.end}}
attendees
{{body.email}}
eventId
htmlLink

Створює подію в основному Google Календарі та (опціонально) розсилає запрошення учасникам.

Входи

ВхідТипОпис
summarystringОбов'язково. Назва події.
startstringОбов'язково. ISO 8601 datetime з offset — наприклад 2026-06-15T14:00:00+03:00 або 2026-06-15T11:00:00Z.
endstringОбов'язково. ISO 8601 datetime у тому ж форматі що й start.
descriptionstringОпціональний опис / нотатки до події.
locationstringОпціональне місце — адреса, назва кімнати або URL.
attendeesstringОпціональний список учасників через кому — [email protected], [email protected]. Кожен отримує запрошення на email (див. Примітки).

Виходи

ВихідТипОпис
eventIdstringId події в Google Calendar
htmlLinkstringПряме посилання на подію в інтерфейсі Google Calendar
errorstringПорожній при успіху. Містить повідомлення Google при статусі ERROR

Необхідні дозволи

Дія потребує capability Manage Calendar events на Google-з'єднанні (OAuth scope calendar.events). Якщо користувач зняв галочку у візарді — запуск впаде з 403. Відкрийте картку з'єднання, натисніть Reconnect Google, увімкніть Manage Calendar events.

Примітки

  • Дія робить POST з sendUpdates=all, тому учасники отримують листи-запрошення одразу при створенні. Окремого параметра для тихого створення поки не передбачено — якщо потрібно, відкрий запит на додатковий input.
  • Події створюються тільки в основному календарі. Спільні / вторинні календарі поки не підтримуються.
  • Час має бути в форматі ISO 8601 з offset (+03:00 або Z). Без offset Google повертає Invalid time format.
  • Повноденні події (тільки дата, без часу) на цій дії не підтримуються — передавайте повні timestamp'и.

Приклади використання

  • Форма → зустріч — API Trigger отримує запис на консультацію → Create Calendar Event для слота, attendees = клієнт + ви.
  • Telegram → стендап — команда /standup у чаті створює 15-хвилинний слот завтра з вашою командою.
  • Helper flow для розкладу — батьківський flow збирає список завдань, helper flow створює по події на кожне.

Можливі помилки

error outputЩо означає
Event summary (title) is requiredInput summary після резолву порожній.
Event start time is required / Event end time is requiredТе саме для часових полів.
Invalid time format (або інша 400 від Google)start / end не валідний ISO 8601 datetime, або не вистачає offset.
Insufficient PermissionЗ'єднанню не вистачає calendar.events. Перепідключіть з відміченою галкою.
Google connection has been revoked — reconnect it from the Connections page.Користувач відкликав Fainflow зі свого Google-акаунта, або refresh token протух.