Calendly Wrapper

Calendly is a scheduling automation platform used by teams to schedule, prepare for, and follow up on external meetings. It removes the back-and-forth of finding meeting times and integrates with calendars, CRMs, and workflows across the stack.

The Calendly Wrapper brings your scheduling data into Postgres as queryable foreign tables. Query scheduled events, event types, organization memberships, and more with plain SQL and join them against your application data. All objects are read-only, and the wrapper works with Supabase Vault for secure token management and is built on WebAssembly (Wasm) for lightweight, sandboxed execution.

Preparation

Before you get started, make sure the wrappers extension is installed on your database:

and then enable the Wasm foreign data wrapper:

Secure your credentials (optional)

By default, Postgres stores FDW credentials inside pg_catalog.pg_foreign_server in plain text. Anyone with access to this table will be able to view these credentials. Wrappers is designed to work with Vault, which provides an additional level of security for storing credentials. We recommend using Vault to store your credentials.

Connecting to Calendly

We need to provide Postgres with the credentials to access Calendly, and any additional options. We can do this using the create server command.

Note: the organization option requires your Calendly organization URI. You can retrieve this after connecting by querying the calendly.current_user table: select attrs->>'current_organization' as org_uri from calendly.current_user;

With Vault:

Without Vault:

Note: the fdw_package_* options are required and specify the Wasm package metadata. See the Available Versions table above for the full list.

Resources

• Official supabase/wrappers documentation: Calendly
• Enable in Supabase dashboard
• supabase/wrappers on GitHub
• Calendly API documentation
• Calendly product page