Connect your Calendly account to Goodweek to manage scheduling links, events, and availability directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Calendly, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Calendly integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Calendly integration uses OAuth 2.0 and does not require any admin-level approval within Calendly before users can connect.
⚠️ If your Calendly account is connected to Microsoft 365 / Outlook
If users in your organization use Calendly with Microsoft 365 Single Sign-On or have their Outlook calendar connected to Calendly, they may see an "Approval Required" or "Admin consent required" prompt during the connection flow. This is caused by Microsoft Entra ID requiring admin consent for the Microsoft Graph permissions that Calendly requests (specifically Calendars.ReadWrite.shared), and is not related to Goodweek or Composio.
To resolve this, a Microsoft 365 Global Administrator must grant tenant-wide admin consent for the Calendly app in Microsoft Entra:
Go to the Microsoft Entra admin center at entra.microsoft.com.
Navigate to Enterprise applications → search for "Calendly".
Open the Calendly application → Permissions → Grant admin consent for [your organization].
Make sure "Consent on behalf of your organization" is selected before confirming.
User Connection
In Goodweek, go to Integrations.
Find Calendly and click Connect.
You will be redirected to Calendly, where you will be asked to sign in and authorize access.
Click Allow to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the Calendly event types, scheduled events, and availability that your individual user account has access to.
If your organization uses Calendly Teams, team-level data is only accessible if your Calendly role includes the appropriate permissions.
You can revoke Goodweek's access at any time from Calendly → Integrations → Connected apps → Composio → Remove.
Available Tools
Tool | Description | Type |
List Event Types | Lists all event types associated with a specified user or organization in Calendly. | Read |
Get Event Type | Retrieves details for a specific Calendly event type by its UUID. | Read |
Get Event Type Availability | Retrieves availability schedules configured for a specific event type. | Read |
List Event Type Available Times | Fetches available time slots for an event type within a specified time range. | Read |
Create Event Type | Creates a new one-on-one event type in Calendly. | Write |
Update Event Type | Updates an existing one-on-one event type's settings. | Write |
List Scheduled Events | Retrieves a list of scheduled Calendly events for a user or organization with optional filters. | Read |
Get Event | Retrieves a specific scheduled Calendly event by its UUID. | Read |
List Event Invitees | Retrieves a list of invitees for a specific event with optional status and email filters. | Read |
Get Event Invitee | Retrieves detailed information about a specific event invitee. | Read |
Create Scheduling Link | Creates a scheduling link that can be used to book an event. | Write |
Create Single Use Scheduling Link | Creates a one-time scheduling link for an event type, expiring after one booking. | Write |
Create Share | Creates a customizable, one-time share link for a Calendly event type with optional setting overrides. | Write |
Get User | Retrieves comprehensive details for an existing Calendly user. | Read |
Get User Availability Schedule | Retrieves a user's availability schedule by its UUID. | Read |
List User Availability Schedules | Retrieves all availability schedules for a specified Calendly user. | Read |
List User Busy Times | Fetches a user's busy time intervals from internal and external calendars for up to 7 days. | Read |
Get Organization | Retrieves information about a specific Calendly organization. | Read |
List Organization Memberships | Retrieves a list of organization memberships. | Read |
List Routing Forms | Retrieves routing forms for a specified organization. | Read |
List Routing Form Submissions | Lists all submissions associated with a specific routing form. | Read |
Mark Invitee as No-Show | Marks an invitee as a no-show for a scheduled event. | Read |
Cancel Scheduled Event | Cancels a scheduled Calendly event by creating a cancellation record. | ⚠️ Destructive |
Delete Invitee Data | Permanently removes all invitee data associated with specified emails from past organization events, for data privacy purposes. | ⚠️ Destructive |
Use Cases
Check your schedule and upcoming meetings. Retrieve a list of your scheduled Calendly events and their invitees directly from Goodweek to review your calendar without switching apps.
Find available slots before proposing a meeting. Query available times for a specific event type to identify open slots before reaching out to a client or colleague to schedule a meeting.
Generate scheduling links on demand. Create one-time or standard scheduling links for a specific event type directly from a Goodweek conversation, ready to share with a contact.
Review routing form submissions. Access responses from Calendly routing forms to understand how inbound meeting requests are being directed across your team.
Troubleshooting
"Approval Required" or "Admin consent required" when connecting
This is caused by Microsoft Entra requiring admin consent for the Microsoft 365 permissions that Calendly requests. A Microsoft 365 Global Administrator must grant consent as described in the admin setup section above.
Connection worked before but now shows "Approval Required"
Calendly recently added the Calendars.ReadWrite.shared Microsoft Graph scope. The admin may need to re-grant consent to include this new scope. Follow the steps in the warning section above.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Calendly integration from the Goodweek Admin Panel under the Integrations tab.