Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

SavvyCal

Scheduling tool that lets invitees overlay their calendar when picking a time.

CategoryProductivity
AuthenticationOAuth 2.0, custom
Version0.2.0
Published scopes0 published scopes
Last updatedSeptember 23, 2026

Overview

Connect SavvyCal with Flows360

Scheduling tool that lets invitees overlay their calendar when picking a time.

Use the SavvyCal connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 15 actions and 3 triggers.

Available actions

  • Create Event
  • Cancel Event
  • Get Event
  • List Events
  • Find Events by Attendee Email
  • List Scheduling Links
  • Get Scheduling Link
  • Get Available Slots
  • Plus 7 additional declared actions.

Available triggers

  • New Event
  • New Poll Response
  • Workflow Action Triggered

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: SavvyCal
  • Package: @activepieces/piece-savvycal@0.2.0
  • Exact artifact digest: sha256:1edc6d789125b4a0bd90f07613028fea930d0619a18bee6330b2858986f72386
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Create Event (create_event), Books a meeting on a scheduling link at a specific time slot. Classification: read.
  • Cancel Event (cancel_event), Cancels a scheduled meeting in SavvyCal. Classification: read.
  • Get Event (get_event), Retrieves the details of a specific scheduled meeting by its ID. Classification: read.
  • List Events (list_events), Returns a list of scheduled meetings from your SavvyCal account. Classification: read.
  • Find Events by Attendee Email (find_events_by_email), Returns all events where the attendee's email matches the given address. Classification: read.
  • List Scheduling Links (list_scheduling_links), Returns all scheduling links configured in your SavvyCal account. Classification: read.
  • Get Scheduling Link (get_scheduling_link), Retrieves the details of a specific scheduling link by its ID. Classification: read.
  • Get Available Slots (get_link_slots), Returns available time slots for booking on a scheduling link. Useful for displaying availability or for picking a slot before calling Create Event. Classification: read.
  • Toggle Scheduling Link (toggle_scheduling_link), Switches a scheduling link between active and disabled states. Classification: read.
  • Duplicate Scheduling Link (duplicate_scheduling_link), Creates a copy of an existing scheduling link. Classification: read.
  • Delete Scheduling Link (delete_scheduling_link), Permanently deletes a scheduling link from your SavvyCal account. Classification: read.
  • List Workflows (list_workflows), Returns all workflows configured in your SavvyCal account. Classification: read.
  • Get Workflow Rules (get_workflow_rules), Returns the rules configured for a specific workflow. Classification: read.
  • Get Current User (get_current_user), Retrieves the profile of the currently authenticated SavvyCal user. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • New Event, webhook.
  • New Poll Response, webhook.
  • Workflow Action Triggered, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

AuthenticationOAuth 2.0, custom
Supported objects18
Supported actions15
Triggers3

Authentication

Authentication method: OAuth 2.0, custom

Authentication profiles

connection · oauth2
connection_2 · custom
  • Personal Access Token Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Event Yes No Books a meeting on a scheduling link at a specific time slot.
Cancel Event Yes No Cancels a scheduled meeting in SavvyCal.
Get Event Yes No Retrieves the details of a specific scheduled meeting by its ID.
List Events Yes No Returns a list of scheduled meetings from your SavvyCal account.
Find Events by Attendee Email Yes No Returns all events where the attendee's email matches the given address.
List Scheduling Links Yes No Returns all scheduling links configured in your SavvyCal account.
Get Scheduling Link Yes No Retrieves the details of a specific scheduling link by its ID.
Get Available Slots Yes No Returns available time slots for booking on a scheduling link. Useful for displaying availability or for picking a slot before calling Create Event.
Toggle Scheduling Link Yes No Switches a scheduling link between active and disabled states.
Duplicate Scheduling Link Yes No Creates a copy of an existing scheduling link.
Delete Scheduling Link Yes No Permanently deletes a scheduling link from your SavvyCal account.
List Workflows Yes No Returns all workflows configured in your SavvyCal account.
Get Workflow Rules Yes No Returns the rules configured for a specific workflow.
Get Current User Yes No Retrieves the profile of the currently authenticated SavvyCal user.
Custom API Call Yes No Make a custom API call to a specific endpoint
New Event Yes No webhook trigger declared by the pinned package.
New Poll Response Yes No webhook trigger declared by the pinned package.
Workflow Action Triggered Yes No webhook trigger declared by the pinned package.

Supported actions

Create Event · Read

Books a meeting on a scheduling link at a specific time slot.

create_event · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to book a meeting on.
  • start_at · string · Required, The start date and time of the meeting. Must match an available slot on the scheduling link.
  • end_at · string · Required, The End date and time of the meeting
  • attendee_name · string · Required, Full name of the person booking the meeting.
  • attendee_email · string · Required, Email address of the person booking the meeting.
  • time_zone · string · Required, Attendee's local time zone in Olson format (e.g. America/New_York, Europe/London, Africa/Lagos).
  • phone_number · string · Optional, Attendee's phone number in international format (e.g. +15555555555). Required only if the scheduling link asks for it.
  • custom_fields · object · Optional, Additional questions configured on the scheduling link (e.g. Company, Why are we meeting?). Filled in dynamically based on the selected link.
  • metadata · object · Optional, Custom key/value pairs to attach to the event. Useful for tracking the source flow or correlating with external systems.
Cancel Event · Read

Cancels a scheduled meeting in SavvyCal.

cancel_event · Risk: low · Retry: safe

Inputs

  • event_id · string · Required, The unique ID of the event to cancel. You can find this from the output of a trigger or the List Events / Get Event actions.
Get Event · Read

Retrieves the details of a specific scheduled meeting by its ID.

get_event · Risk: low · Retry: safe

Inputs

  • event_id · string · Required, The unique ID of the event. You can find this in the event URL in SavvyCal, or from the output of a trigger or List Events action.
List Events · Read

Returns a list of scheduled meetings from your SavvyCal account.

list_events · Risk: low · Retry: safe

Inputs

  • states · array · Optional, Filter events by their current status. Leave empty to return all statuses.
  • start_after · string · Optional, Only return events that start after this date and time.
  • start_before · string · Optional, Only return events that start before this date and time.
  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_ids · array · Optional, Only return events booked through the selected scheduling links. Leave empty for all links.
  • limit · number · Optional, Maximum number of events to return. Leave empty to return all matching events.
Find Events by Attendee Email · Read

Returns all events where the attendee's email matches the given address.

find_events_by_email · Risk: low · Retry: safe

Inputs

  • attendee_email · string · Required, The email address of the attendee to search for.
  • start_after · string · Optional, Only search events starting after this date. Use this to limit the search scope and improve performance.
  • start_before · string · Optional, Only search events starting before this date.
List Scheduling Links · Read

Returns all scheduling links configured in your SavvyCal account.

list_scheduling_links · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
Get Scheduling Link · Read

Retrieves the details of a specific scheduling link by its ID.

get_scheduling_link · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to retrieve.
Get Available Slots · Read

Returns available time slots for booking on a scheduling link. Useful for displaying availability or for picking a slot before calling Create Event.

get_link_slots · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to query slots for.
Toggle Scheduling Link · Read

Switches a scheduling link between active and disabled states.

toggle_scheduling_link · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to toggle.
Duplicate Scheduling Link · Read

Creates a copy of an existing scheduling link.

duplicate_scheduling_link · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to duplicate.
Delete Scheduling Link · Read

Permanently deletes a scheduling link from your SavvyCal account.

delete_scheduling_link · Risk: low · Retry: safe

Inputs

  • team_id · string · Optional, Filter scheduling links by team. Leave empty to show all teams.
  • link_id · string · Required, Select the scheduling link to delete. This action cannot be undone.
List Workflows · Read

Returns all workflows configured in your SavvyCal account.

list_workflows · Risk: low · Retry: safe

Get Workflow Rules · Read

Returns the rules configured for a specific workflow.

get_workflow_rules · Risk: low · Retry: safe

Inputs

  • workflow_id · string · Required, Select the workflow whose rules you want to retrieve.
Get Current User · Read

Retrieves the profile of the currently authenticated SavvyCal user.

get_current_user · Risk: low · Retry: safe

Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Triggers

New Event · Webhook

Triggers when a SavvyCal event occurs. Select one or more event types, or leave empty to trigger on all types.

Inputs

  • event_types · array
  • team_id · string
  • link_ids · array
New Poll Response · Webhook

Triggers when a poll response is created or updated in SavvyCal.

Inputs

  • event_types · array
Workflow Action Triggered · Webhook

Triggers when a workflow action is triggered in SavvyCal.

Setup

Setup

  1. Add the SavvyCal connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Personal Access Token (token), required; stored as a sensitive connection value.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-savvycal@0.2.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 15 actions and 3 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required SavvyCal connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-savvycal@0.2.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com