Skip to main content
Use Check Availability before Create an Appointment when the caller needs to choose from open times. If another block already provides the start and end time, use Create an Appointment directly.

​
Connect Google Calendar

Add Google Calendar in the Live Call stage, then open Setup:
  1. Select Check Availability or Create an Appointment.
  2. Select Connect to Google Calendar and authorize the account.
  3. Continue to Configure.
The connection belongs to the agent and can be reused across its flows. Other agents need their own connection.

​
Check availability

Check Availability reads events from the selected calendar, excludes conflicts, and returns open slots within the schedule you configure. Search Period and Available Time Slots are under Advanced Settings. Start Time, Duration, Search Period, and Available Time Slots can use values from Available Variables. Enter a fixed Start Time in ISO format with a timezone offset. Available Times use the agent’s timezone, so confirm it before testing the schedule.

​
Use the available slots

Check Availability provides Available Appointment Slots, an array containing the start and end of each returned slot. Later blocks can select it from Available Variables to present options, make a decision, or create an appointment after the caller chooses a time.

​
Create an appointment

Create an Appointment adds an event to the selected calendar and sends a Google Calendar invitation to the configured email address. Appointment Name and Appointment Description are optional. All fields except Calendar ID can use variables available before the block runs. Include a timezone offset in both Start Time and End Time, and make sure End Time is later.

​
Route the result

Google Calendar provides Success and Error routes:
  • Success runs when the selected calendar action completes. For Check Availability, this includes a successful check that finds no open slots.
  • Error runs when Phonely cannot complete the request to Google Calendar.
Both actions support interim messages and call outcome tagging. These are covered in Common Block Settings.

​
Test Google Calendar

The block test uses the selected account and calendar:
  • Check Availability reads real events and shows the slots it finds. It does not change the calendar.
  • Create an Appointment creates a real event and sends a real invitation to the configured email address.
For Check Availability, use representative dates, availability windows, and appointment durations. Confirm that busy events are excluded and that Available Appointment Slots contains the expected slots for later blocks. For Create an Appointment, use a calendar and attendee email that are safe for testing. Confirm the event details in Google Calendar and remove the test event when it is no longer needed. After the block test, test the complete flow, including what should happen if the calendar request fails.
Testing Create an Appointment creates a real calendar event and may send an invitation. Use test details that will not affect customers or production schedules.

​
Troubleshooting

Confirm that the connected Google account can access the calendar, then use the refresh button beside Calendar ID. If the account or its permissions changed, return to Setup and reconnect it.
Confirm the Start Time, Duration, Search Period, and Available Times. Check that the agent’s timezone matches the schedule and that existing or all-day events do not occupy the requested window. A check with no open slots follows Success, so handle the empty result in the next block.
Confirm the agent’s timezone and the timezone offset in Start Time. Review the configured Available Times, then run the block test again with a known date and calendar event.
Check whether the flow followed the Error route, then review the selected calendar, attendee email, start and end times, and timezone offsets. Reconnect the account if its permissions changed. After a successful test, verify the event and invitation in Google Calendar.
Last modified on July 17, 2026