View as Markdown
Calendly icon

Calendly ACTION

List Events

List scheduled Calendly events. Scope the results by providing at most one of Organization URI, User URI, or Group UUID; if none is provided, events for the authenticated user are returned (supplying more than one raises a configuration error). Narrow the results further with an invitee email to return only events scheduled with that invitee. Filter by date range using Min Start Time and/or Max Start Time, both ISO 8601 datetimes in UTC (e.g. 2026-08-01T00:00:00Z). Each returned event includes a uri; the trailing UUID segment is the event UUID used by downstream actions such as Get Event, List Event Invitees, Get Event Invitee, and Cancel Event. Example: called with no props, returns the authenticated user's upcoming events, each like { name: "30 Minute Meeting", uri: "https://api.calendly.com/scheduled_events/a1b2c3d4-e5f6-7890-abcd-ef1234567890", status: "active" }. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Calendly account once, then configure and run List Events from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "calendly_v2-list-events",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    calendly_v2: { authProvisionId: "apn_xxxxxxx" },
    organization: "Organization URI",
    user: "User URI",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Events inputs
Property Type Description
organization Organization URI string
Returns events for the specified organization. Provide only one of Organization, User, or Group.
Optional
user User URI string
Returns events for the specified user. Provide only one of Organization, User, or Group.
Optional
group Group UUID string
Returns events for the specified group. Provide only one of Organization, User, or Group.
Optional
inviteeEmail Inviteee Email string
Return events that are scheduled with the invitee associated with this email address
Optional
status Event Status string
Whether the scheduled event is active or canceled
Optional
paginate Paginate boolean
Whether to paginate or not
Optional
maxResults Max Results integer
Maximum number of results to return (min 1, max 1000).
Optional
minStartTime Min Start Time string
Include only events with start times on or after this ISO 8601 datetime in UTC, e.g. 2026-08-01T00:00:00Z. Maps to the min_start_time query param.
Optional
maxStartTime Max Start Time string
Include only events with start times prior to this ISO 8601 datetime in UTC, e.g. 2026-08-31T23:59:59Z. Maps to the max_start_time query param.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
calendly_v2-list-events
Version
0.0.9
App
Calendly
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes