- Read the connected user and organization profile
- List event types and scheduled events with filters and pagination
- Fetch invitee details for scheduled events
- Create single-use scheduling links for embedded booking flows
- Cancel scheduled events on behalf of the connected user
Common use cases and example apps
How to connect Calendly
Workspace admins and owners can connect Calendly. You can create multiple Calendly connections using different accounts, which is useful for separating environments or managing different teams. When the connection is created, Calendly becomes available across all projects in the workspace. Anyone building in a project can ask Lovable in chat to link their project to it.Prerequisites
Before connecting Calendly, make sure you have:- A Calendly account
- Lovable workspace owner or admin role
All API requests made through this connector count against Calendly API limits according to your Calendly plan. Billing and quota are handled directly by Calendly, not Lovable.
Set up your Calendly connection
1
Open Calendly in Connectors
Go to Connectors, then App connectors, and select Calendly.
2
Add a connection
Click Add connection.
3
Name the connection
In Display name, name the connection (for example,
Calendly Prod). This name is only used inside Lovable to identify the connection.4
Choose scopes
Expand Advanced settings to choose the permissions your app requests. Lovable pre-selects default scopes that cover common scheduling, booking, and event management use cases. You can enable additional scopes for more advanced workflows or turn off defaults you don’t need.The
users:read scope is required and cannot be disabled. Only the scopes you select are sent to Calendly during authorization, and Lovable exposes the approved scopes to the agent so it knows which Calendly capabilities your app can use.Default scopes (pre-selected):Additional scopes (off by default):
Pick scopes for common use cases:
- Booking portals and meeting dashboards: the defaults are enough. They cover reading event types, scheduled events, and invitees, and creating single-use scheduling links.
- Managing event types or availability from your app: add
event_types:writeandavailability:write. - Routing form integrations: add
routing_forms:readto read form submissions and route invitees. - Webhook automation: add
webhooks:readandwebhooks:writeto manage Calendly webhook subscriptions from your app. - CRM-style contact sync: add
contacts:readandcontacts:writeto read or update Calendly contacts. - Admin and compliance tooling: add
organizations:write,activity_log:read, anddata_compliance:writefor user management, audit views, or GDPR-style data deletion flows.
5
Choose who can access this connection
Under Who can access this connection, decide who in your workspace can use the connection:
- Only you (default): only the person creating the connection can use it and its associated data.
- Invite specific people: only you and explicitly added workspace members can use the connection and its associated data.
- Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.
6
Connect to Calendly and authorize
Click Connect. The Calendly authorization window opens, so make sure your browser does not block pop-ups. If it does, Lovable redirects you instead.Sign in to Calendly if prompted, review the requested permissions, and click Allow.Lovable redirects you back with a confirmation.
Limitations
The Calendly connector cannot:- Access Calendly resources that are outside the scopes approved for the connection.
- Use a Calendly endpoint that is unavailable on the connected Calendly plan.
- Call Calendly directly from browser code. Apps should use server-side requests through the Lovable connector gateway.
- Support per-end-user Calendly login. Each connection represents a single Calendly account shared across all projects linked to it.
How to unlink projects from a connection
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:1
Open Connectors
Open Connectors and select .
2
Open the connection
Open the connection you want to manage.
3
Select projects
Under Linked projects, check the projects you want to unlink.
4
Confirm
Click Unlink projects and confirm.
How to delete a connection
Workspace admins and owners can delete connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it. Before deleting, review the Linked projects section to see which projects are currently using the connection. To delete a connection:1
Open Connectors
Open Connectors and select .
2
Open the connection
Open the connection you want to remove.
3
Review linked projects
Review the Linked projects section.
4
Delete
Under Delete this connection, click Delete and confirm.