A quick 30-minute catch-up call
\",\n \"profile\": {\n \"type\": \"User\",\n \"name\": \"Alice Johnson\",\n \"owner\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet an Event Type\n\nGET /calendly/event_types/{uuid}" }, { "title": "Scheduled Events", "body": "List Scheduled Events\n\nGET /calendly/scheduled_events\n\nQuery parameters:\n\nuser - User URI to filter events\norganization - Organization URI to filter events\ninvitee_email - Filter by invitee email\nstatus - Filter by status (active, canceled)\nmin_start_time - Filter events starting after this time (ISO 8601)\nmax_start_time - Filter events starting before this time (ISO 8601)\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\nsort - Sort order (e.g., start_time:asc)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&status=active&min_start_time=2025-03-01T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD\",\n \"name\": \"30 Minute Meeting\",\n \"status\": \"active\",\n \"start_time\": \"2025-03-15T14:00:00.000000Z\",\n \"end_time\": \"2025-03-15T14:30:00.000000Z\",\n \"event_type\": \"https://api.calendly.com/event_types/CCCCCCCCCCCCCCCC\",\n \"location\": {\n \"type\": \"zoom\",\n \"join_url\": \"https://zoom.us/j/123456789\"\n },\n \"invitees_counter\": {\n \"total\": 1,\n \"active\": 1,\n \"limit\": 1\n },\n \"created_at\": \"2025-03-10T09:15:00.000000Z\",\n \"updated_at\": \"2025-03-10T09:15:00.000000Z\",\n \"event_memberships\": [\n {\n \"user\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n ]\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet a Scheduled Event\n\nGET /calendly/scheduled_events/{uuid}\n\nCancel a Scheduled Event\n\nPOST /calendly/scheduled_events/{uuid}/cancellation\nContent-Type: application/json\n\n{\n \"reason\": \"Meeting rescheduled\"\n}\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'reason': 'Meeting rescheduled'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events/DDDDDDDDDDDDDDDD/cancellation', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF" }, { "title": "Invitees", "body": "List Event Invitees\n\nGET /calendly/scheduled_events/{event_uuid}/invitees\n\nQuery parameters:\n\nstatus - Filter by status (active, canceled)\nemail - Filter by invitee email\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\nsort - Sort order (e.g., created_at:asc)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events/DDDDDDDDDDDDDDDD/invitees')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD/invitees/EEEEEEEEEEEEEEEE\",\n \"email\": \"bob.smith@example.com\",\n \"name\": \"Bob Smith\",\n \"status\": \"active\",\n \"timezone\": \"America/Los_Angeles\",\n \"event\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD\",\n \"created_at\": \"2025-03-10T09:15:00.000000Z\",\n \"updated_at\": \"2025-03-10T09:15:00.000000Z\",\n \"questions_and_answers\": [\n {\n \"question\": \"What would you like to discuss?\",\n \"answer\": \"Project timeline review\",\n \"position\": 0\n }\n ],\n \"tracking\": {\n \"utm_source\": null,\n \"utm_medium\": null,\n \"utm_campaign\": null\n },\n \"cancel_url\": \"https://calendly.com/cancellations/EEEEEEEEEEEEEEEE\",\n \"reschedule_url\": \"https://calendly.com/reschedulings/EEEEEEEEEEEEEEEE\"\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet an Invitee\n\nGET /calendly/scheduled_events/{event_uuid}/invitees/{invitee_uuid}\n\nCreate Event Invitee (Scheduling API)\n\nSchedule a meeting programmatically by creating an invitee. Requires a paid Calendly plan.\n\nPOST /calendly/event_types/{event_type_uuid}/invitees\nContent-Type: application/json\n\n{\n \"start_time\": \"2025-03-20T15:00:00Z\",\n \"email\": \"bob.smith@example.com\",\n \"name\": \"Bob Smith\",\n \"timezone\": \"America/Los_Angeles\",\n \"location\": {\n \"kind\": \"zoom\"\n },\n \"questions_and_answers\": [\n {\n \"question_uuid\": \"QQQQQQQQQQQQQQQ\",\n \"answer\": \"Project timeline review\"\n }\n ]\n}\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'start_time': '2025-03-20T15:00:00Z', 'email': 'bob.smith@example.com', 'name': 'Bob Smith'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/event_types/CCCCCCCCCCCCCCCC/invitees', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nNote: The start_time must correspond to a valid available slot. Use the /event_type_available_times endpoint to find available times." }, { "title": "Availability", "body": "Get Event Type Available Times\n\nGET /calendly/event_type_available_times\n\nQuery parameters:\n\nevent_type - Event type URI (required)\nstart_time - Start of time range (ISO 8601, required)\nend_time - End of time range (ISO 8601, required, max 7 days from start)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/event_type_available_times?event_type=https://api.calendly.com/event_types/CCCCCCCCCCCCCCCC&start_time=2025-03-15T00:00:00Z&end_time=2025-03-22T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"collection\": [\n {\n \"status\": \"available\",\n \"invitees_remaining\": 1,\n \"start_time\": \"2025-03-17T14:00:00.000000Z\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson/30min/2025-03-17T14:00:00Z\"\n },\n {\n \"status\": \"available\",\n \"invitees_remaining\": 1,\n \"start_time\": \"2025-03-17T14:30:00.000000Z\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson/30min/2025-03-17T14:30:00Z\"\n }\n ]\n}\n\nGet User Busy Times\n\nGET /calendly/user_busy_times\n\nQuery parameters:\n\nuser - User URI (required)\nstart_time - Start of time range (ISO 8601, required)\nend_time - End of time range (ISO 8601, required, max 7 days from start)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/user_busy_times?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&start_time=2025-03-15T00:00:00Z&end_time=2025-03-22T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"collection\": [\n {\n \"type\": \"calendly\",\n \"start_time\": \"2025-03-17T10:00:00.000000Z\",\n \"end_time\": \"2025-03-17T11:00:00.000000Z\"\n },\n {\n \"type\": \"external\",\n \"start_time\": \"2025-03-18T14:00:00.000000Z\",\n \"end_time\": \"2025-03-18T15:00:00.000000Z\"\n }\n ]\n}\n\nGet User Availability Schedules\n\nGET /calendly/user_availability_schedules\n\nQuery parameters:\n\nuser - User URI (required)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/user_availability_schedules?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF" }, { "title": "Organization", "body": "List Organization Memberships\n\nGET /calendly/organization_memberships\n\nQuery parameters:\n\norganization - Organization URI (required)\nuser - User URI to filter\nemail - Email to filter\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/organization_memberships?organization=https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/organization_memberships/FFFFFFFFFFFFFFFF\",\n \"role\": \"admin\",\n \"user\": {\n \"uri\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\",\n \"name\": \"Alice Johnson\",\n \"email\": \"alice.johnson@acme.com\"\n },\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"created_at\": \"2024-01-15T10:30:00.000000Z\",\n \"updated_at\": \"2025-06-20T14:45:00.000000Z\"\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}" }, { "title": "Webhooks", "body": "Webhooks require a paid Calendly plan (Standard, Teams, or Enterprise).\n\nList Webhook Subscriptions\n\nGET /calendly/webhook_subscriptions\n\nQuery parameters:\n\norganization - Organization URI (required)\nscope - Filter by scope (user, organization)\nuser - User URI to filter (when scope is user)\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions?organization=https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB&scope=organization')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nCreate Webhook Subscription\n\nPOST /calendly/webhook_subscriptions\nContent-Type: application/json\n\n{\n \"url\": \"https://example.com/webhook\",\n \"events\": [\"invitee.created\", \"invitee.canceled\"],\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"scope\": \"organization\",\n \"signing_key\": \"your-secret-key\"\n}\n\nAvailable events:\n\ninvitee.created - Triggered when an invitee schedules an event\ninvitee.canceled - Triggered when an invitee cancels an event\nrouting_form_submission.created - Triggered when a routing form is submitted\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'url': 'https://example.com/webhook', 'events': ['invitee.created', 'invitee.canceled'], 'organization': 'https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB', 'scope': 'organization'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n \"resource\": {\n \"uri\": \"https://api.calendly.com/webhook_subscriptions/GGGGGGGGGGGGGGGG\",\n \"callback_url\": \"https://example.com/webhook\",\n \"created_at\": \"2025-03-01T12:00:00.000000Z\",\n \"updated_at\": \"2025-03-01T12:00:00.000000Z\",\n \"retry_started_at\": null,\n \"state\": \"active\",\n \"events\": [\"invitee.created\", \"invitee.canceled\"],\n \"scope\": \"organization\",\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"user\": null,\n \"creator\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n}\n\nGet a Webhook Subscription\n\nGET /calendly/webhook_subscriptions/{uuid}\n\nDelete a Webhook Subscription\n\nDELETE /calendly/webhook_subscriptions/{uuid}\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions/GGGGGGGGGGGGGGGG', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nReturns 204 No Content on success." }, { "title": "Pagination", "body": "Use page_token for pagination. Response includes pagination.next_page_token when more results exist:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events?user=USER_URI&page_token=NEXT_PAGE_TOKEN')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF" }, { "title": "JavaScript", "body": "const response = await fetch(\n 'https://gateway.maton.ai/calendly/scheduled_events?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&status=active',\n {\n headers: {\n 'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n }\n }\n);\nconst data = await response.json();" }, { "title": "Python", "body": "import os\nimport requests\n\nresponse = requests.get(\n 'https://gateway.maton.ai/calendly/scheduled_events',\n headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n params={\n 'user': 'https://api.calendly.com/users/AAAAAAAAAAAAAAAA',\n 'status': 'active'\n }\n)\ndata = response.json()" }, { "title": "Notes", "body": "Resource identifiers are URIs (e.g., https://api.calendly.com/users/AAAAAAAAAAAAAAAA)\nTimestamps are in ISO 8601 format\nThe Scheduling API (Create Event Invitee) requires a paid Calendly plan\nWebhooks are not available on Calendly's free plan\nAvailability endpoints have a 7-day maximum range per request and start_time must be in the future\nThe API does not support creating or managing event types programmatically\nIMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get \"Invalid API key\" errors when piping." }, { "title": "Error Handling", "body": "StatusMeaning400Bad request or missing Calendly connection401Invalid or missing Maton API key403Forbidden - insufficient permissions or plan restrictions404Resource not found424External calendar error (calendar integration issue on Calendly side)429Rate limited4xx/5xxPassthrough error from Calendly API" }, { "title": "Troubleshooting: API Key Issues", "body": "Check that the MATON_API_KEY environment variable is set:\n\necho $MATON_API_KEY\n\nVerify the API key is valid by listing connections:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF" }, { "title": "Troubleshooting: Invalid App Name", "body": "Ensure your URL path starts with calendly. For example:\n\nCorrect: https://gateway.maton.ai/calendly/users/me\nIncorrect: https://gateway.maton.ai/users/me" }, { "title": "Resources", "body": "Calendly Developer Portal\nAPI Reference\nAPI Use Cases\nMaton Community\nMaton Support" } ], "body": "Calendly\n\nAccess the Calendly API with managed OAuth authentication. Retrieve event types, scheduled events, invitees, availability data, and manage webhook subscriptions for scheduling automation.\n\nQuick Start\n# Get current user\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/users/me')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nBase URL\nhttps://gateway.maton.ai/calendly/{native-api-path}\n\n\nReplace {native-api-path} with the actual Calendly API endpoint path. The gateway proxies requests to api.calendly.com and automatically injects your OAuth token.\n\nAuthentication\n\nAll requests require the Maton API key in the Authorization header:\n\nAuthorization: Bearer $MATON_API_KEY\n\n\nEnvironment Variable: Set your API key as MATON_API_KEY:\n\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n\nGetting Your API Key\nSign in or create an account at maton.ai\nGo to maton.ai/settings\nCopy your API key\nConnection Management\n\nManage your Calendly OAuth connections at https://ctrl.maton.ai.\n\nList Connections\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=calendly&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nCreate Connection\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'calendly'}).encode()\nreq = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nGet Connection\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"connection\": {\n \"connection_id\": \"21fd90f9-5935-43cd-b6c8-bde9d915ca80\",\n \"status\": \"ACTIVE\",\n \"creation_time\": \"2025-12-08T07:20:53.488460Z\",\n \"last_updated_time\": \"2026-01-31T20:03:32.593153Z\",\n \"url\": \"https://connect.maton.ai/?session_token=...\",\n \"app\": \"calendly\",\n \"metadata\": {}\n }\n}\n\n\nOpen the returned url in a browser to complete OAuth authorization.\n\nDelete Connection\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nSpecifying Connection\n\nIf you have multiple Calendly connections, specify which one to use with the Maton-Connection header:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/users/me')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\nAPI Reference\nUsers\nGet Current User\nGET /calendly/users/me\n\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/users/me')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"resource\": {\n \"uri\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\",\n \"name\": \"Alice Johnson\",\n \"slug\": \"alice-johnson\",\n \"email\": \"alice.johnson@acme.com\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson\",\n \"timezone\": \"America/New_York\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"created_at\": \"2024-01-15T10:30:00.000000Z\",\n \"updated_at\": \"2025-06-20T14:45:00.000000Z\",\n \"current_organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\"\n }\n}\n\nGet a User\nGET /calendly/users/{uuid}\n\nEvent Types\nList Event Types\nGET /calendly/event_types\n\n\nQuery parameters:\n\nuser - User URI to filter event types\norganization - Organization URI to filter event types\nactive - Filter by active status (true/false)\ncount - Number of results to return (default 20, max 100)\npage_token - Token for pagination\nsort - Sort order (e.g., name:asc, created_at:desc)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/event_types?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&active=true')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/event_types/CCCCCCCCCCCCCCCC\",\n \"name\": \"30 Minute Meeting\",\n \"active\": true,\n \"slug\": \"30min\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson/30min\",\n \"duration\": 30,\n \"kind\": \"solo\",\n \"type\": \"StandardEventType\",\n \"color\": \"#0066FF\",\n \"created_at\": \"2024-02-01T09:00:00.000000Z\",\n \"updated_at\": \"2025-05-15T11:30:00.000000Z\",\n \"description_plain\": \"A quick 30-minute catch-up call\",\n \"description_html\": \"A quick 30-minute catch-up call
\",\n \"profile\": {\n \"type\": \"User\",\n \"name\": \"Alice Johnson\",\n \"owner\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet an Event Type\nGET /calendly/event_types/{uuid}\n\nScheduled Events\nList Scheduled Events\nGET /calendly/scheduled_events\n\n\nQuery parameters:\n\nuser - User URI to filter events\norganization - Organization URI to filter events\ninvitee_email - Filter by invitee email\nstatus - Filter by status (active, canceled)\nmin_start_time - Filter events starting after this time (ISO 8601)\nmax_start_time - Filter events starting before this time (ISO 8601)\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\nsort - Sort order (e.g., start_time:asc)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&status=active&min_start_time=2025-03-01T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD\",\n \"name\": \"30 Minute Meeting\",\n \"status\": \"active\",\n \"start_time\": \"2025-03-15T14:00:00.000000Z\",\n \"end_time\": \"2025-03-15T14:30:00.000000Z\",\n \"event_type\": \"https://api.calendly.com/event_types/CCCCCCCCCCCCCCCC\",\n \"location\": {\n \"type\": \"zoom\",\n \"join_url\": \"https://zoom.us/j/123456789\"\n },\n \"invitees_counter\": {\n \"total\": 1,\n \"active\": 1,\n \"limit\": 1\n },\n \"created_at\": \"2025-03-10T09:15:00.000000Z\",\n \"updated_at\": \"2025-03-10T09:15:00.000000Z\",\n \"event_memberships\": [\n {\n \"user\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n ]\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet a Scheduled Event\nGET /calendly/scheduled_events/{uuid}\n\nCancel a Scheduled Event\nPOST /calendly/scheduled_events/{uuid}/cancellation\nContent-Type: application/json\n\n{\n \"reason\": \"Meeting rescheduled\"\n}\n\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'reason': 'Meeting rescheduled'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events/DDDDDDDDDDDDDDDD/cancellation', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nInvitees\nList Event Invitees\nGET /calendly/scheduled_events/{event_uuid}/invitees\n\n\nQuery parameters:\n\nstatus - Filter by status (active, canceled)\nemail - Filter by invitee email\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\nsort - Sort order (e.g., created_at:asc)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events/DDDDDDDDDDDDDDDD/invitees')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD/invitees/EEEEEEEEEEEEEEEE\",\n \"email\": \"bob.smith@example.com\",\n \"name\": \"Bob Smith\",\n \"status\": \"active\",\n \"timezone\": \"America/Los_Angeles\",\n \"event\": \"https://api.calendly.com/scheduled_events/DDDDDDDDDDDDDDDD\",\n \"created_at\": \"2025-03-10T09:15:00.000000Z\",\n \"updated_at\": \"2025-03-10T09:15:00.000000Z\",\n \"questions_and_answers\": [\n {\n \"question\": \"What would you like to discuss?\",\n \"answer\": \"Project timeline review\",\n \"position\": 0\n }\n ],\n \"tracking\": {\n \"utm_source\": null,\n \"utm_medium\": null,\n \"utm_campaign\": null\n },\n \"cancel_url\": \"https://calendly.com/cancellations/EEEEEEEEEEEEEEEE\",\n \"reschedule_url\": \"https://calendly.com/reschedulings/EEEEEEEEEEEEEEEE\"\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nGet an Invitee\nGET /calendly/scheduled_events/{event_uuid}/invitees/{invitee_uuid}\n\nCreate Event Invitee (Scheduling API)\n\nSchedule a meeting programmatically by creating an invitee. Requires a paid Calendly plan.\n\nPOST /calendly/event_types/{event_type_uuid}/invitees\nContent-Type: application/json\n\n{\n \"start_time\": \"2025-03-20T15:00:00Z\",\n \"email\": \"bob.smith@example.com\",\n \"name\": \"Bob Smith\",\n \"timezone\": \"America/Los_Angeles\",\n \"location\": {\n \"kind\": \"zoom\"\n },\n \"questions_and_answers\": [\n {\n \"question_uuid\": \"QQQQQQQQQQQQQQQ\",\n \"answer\": \"Project timeline review\"\n }\n ]\n}\n\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'start_time': '2025-03-20T15:00:00Z', 'email': 'bob.smith@example.com', 'name': 'Bob Smith'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/event_types/CCCCCCCCCCCCCCCC/invitees', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nNote: The start_time must correspond to a valid available slot. Use the /event_type_available_times endpoint to find available times.\n\nAvailability\nGet Event Type Available Times\nGET /calendly/event_type_available_times\n\n\nQuery parameters:\n\nevent_type - Event type URI (required)\nstart_time - Start of time range (ISO 8601, required)\nend_time - End of time range (ISO 8601, required, max 7 days from start)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/event_type_available_times?event_type=https://api.calendly.com/event_types/CCCCCCCCCCCCCCCC&start_time=2025-03-15T00:00:00Z&end_time=2025-03-22T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"status\": \"available\",\n \"invitees_remaining\": 1,\n \"start_time\": \"2025-03-17T14:00:00.000000Z\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson/30min/2025-03-17T14:00:00Z\"\n },\n {\n \"status\": \"available\",\n \"invitees_remaining\": 1,\n \"start_time\": \"2025-03-17T14:30:00.000000Z\",\n \"scheduling_url\": \"https://calendly.com/alice-johnson/30min/2025-03-17T14:30:00Z\"\n }\n ]\n}\n\nGet User Busy Times\nGET /calendly/user_busy_times\n\n\nQuery parameters:\n\nuser - User URI (required)\nstart_time - Start of time range (ISO 8601, required)\nend_time - End of time range (ISO 8601, required, max 7 days from start)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/user_busy_times?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&start_time=2025-03-15T00:00:00Z&end_time=2025-03-22T00:00:00Z')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"type\": \"calendly\",\n \"start_time\": \"2025-03-17T10:00:00.000000Z\",\n \"end_time\": \"2025-03-17T11:00:00.000000Z\"\n },\n {\n \"type\": \"external\",\n \"start_time\": \"2025-03-18T14:00:00.000000Z\",\n \"end_time\": \"2025-03-18T15:00:00.000000Z\"\n }\n ]\n}\n\nGet User Availability Schedules\nGET /calendly/user_availability_schedules\n\n\nQuery parameters:\n\nuser - User URI (required)\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/user_availability_schedules?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nOrganization\nList Organization Memberships\nGET /calendly/organization_memberships\n\n\nQuery parameters:\n\norganization - Organization URI (required)\nuser - User URI to filter\nemail - Email to filter\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/organization_memberships?organization=https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"collection\": [\n {\n \"uri\": \"https://api.calendly.com/organization_memberships/FFFFFFFFFFFFFFFF\",\n \"role\": \"admin\",\n \"user\": {\n \"uri\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\",\n \"name\": \"Alice Johnson\",\n \"email\": \"alice.johnson@acme.com\"\n },\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"created_at\": \"2024-01-15T10:30:00.000000Z\",\n \"updated_at\": \"2025-06-20T14:45:00.000000Z\"\n }\n ],\n \"pagination\": {\n \"count\": 1,\n \"next_page_token\": null\n }\n}\n\nWebhooks\n\nWebhooks require a paid Calendly plan (Standard, Teams, or Enterprise).\n\nList Webhook Subscriptions\nGET /calendly/webhook_subscriptions\n\n\nQuery parameters:\n\norganization - Organization URI (required)\nscope - Filter by scope (user, organization)\nuser - User URI to filter (when scope is user)\ncount - Number of results (default 20, max 100)\npage_token - Token for pagination\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions?organization=https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB&scope=organization')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nCreate Webhook Subscription\nPOST /calendly/webhook_subscriptions\nContent-Type: application/json\n\n{\n \"url\": \"https://example.com/webhook\",\n \"events\": [\"invitee.created\", \"invitee.canceled\"],\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"scope\": \"organization\",\n \"signing_key\": \"your-secret-key\"\n}\n\n\nAvailable events:\n\ninvitee.created - Triggered when an invitee schedules an event\ninvitee.canceled - Triggered when an invitee cancels an event\nrouting_form_submission.created - Triggered when a routing form is submitted\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'url': 'https://example.com/webhook', 'events': ['invitee.created', 'invitee.canceled'], 'organization': 'https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB', 'scope': 'organization'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n \"resource\": {\n \"uri\": \"https://api.calendly.com/webhook_subscriptions/GGGGGGGGGGGGGGGG\",\n \"callback_url\": \"https://example.com/webhook\",\n \"created_at\": \"2025-03-01T12:00:00.000000Z\",\n \"updated_at\": \"2025-03-01T12:00:00.000000Z\",\n \"retry_started_at\": null,\n \"state\": \"active\",\n \"events\": [\"invitee.created\", \"invitee.canceled\"],\n \"scope\": \"organization\",\n \"organization\": \"https://api.calendly.com/organizations/BBBBBBBBBBBBBBBB\",\n \"user\": null,\n \"creator\": \"https://api.calendly.com/users/AAAAAAAAAAAAAAAA\"\n }\n}\n\nGet a Webhook Subscription\nGET /calendly/webhook_subscriptions/{uuid}\n\nDelete a Webhook Subscription\nDELETE /calendly/webhook_subscriptions/{uuid}\n\n\nExample:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/webhook_subscriptions/GGGGGGGGGGGGGGGG', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nReturns 204 No Content on success.\n\nPagination\n\nUse page_token for pagination. Response includes pagination.next_page_token when more results exist:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/calendly/scheduled_events?user=USER_URI&page_token=NEXT_PAGE_TOKEN')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nCode Examples\nJavaScript\nconst response = await fetch(\n 'https://gateway.maton.ai/calendly/scheduled_events?user=https://api.calendly.com/users/AAAAAAAAAAAAAAAA&status=active',\n {\n headers: {\n 'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n }\n }\n);\nconst data = await response.json();\n\nPython\nimport os\nimport requests\n\nresponse = requests.get(\n 'https://gateway.maton.ai/calendly/scheduled_events',\n headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n params={\n 'user': 'https://api.calendly.com/users/AAAAAAAAAAAAAAAA',\n 'status': 'active'\n }\n)\ndata = response.json()\n\nNotes\nResource identifiers are URIs (e.g., https://api.calendly.com/users/AAAAAAAAAAAAAAAA)\nTimestamps are in ISO 8601 format\nThe Scheduling API (Create Event Invitee) requires a paid Calendly plan\nWebhooks are not available on Calendly's free plan\nAvailability endpoints have a 7-day maximum range per request and start_time must be in the future\nThe API does not support creating or managing event types programmatically\nIMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get \"Invalid API key\" errors when piping.\nError Handling\nStatus\tMeaning\n400\tBad request or missing Calendly connection\n401\tInvalid or missing Maton API key\n403\tForbidden - insufficient permissions or plan restrictions\n404\tResource not found\n424\tExternal calendar error (calendar integration issue on Calendly side)\n429\tRate limited\n4xx/5xx\tPassthrough error from Calendly API\nTroubleshooting: API Key Issues\nCheck that the MATON_API_KEY environment variable is set:\necho $MATON_API_KEY\n\nVerify the API key is valid by listing connections:\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nTroubleshooting: Invalid App Name\nEnsure your URL path starts with calendly. For example:\nCorrect: https://gateway.maton.ai/calendly/users/me\nIncorrect: https://gateway.maton.ai/users/me\nResources\nCalendly Developer Portal\nAPI Reference\nAPI Use Cases\nMaton Community\nMaton Support" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/byungkyu/calendly-api", "publisherUrl": "https://clawhub.ai/byungkyu/calendly-api", "owner": "byungkyu", "version": "1.0.3", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/calendly-api", "downloadUrl": "https://openagent3.xyz/downloads/calendly-api", "agentUrl": "https://openagent3.xyz/skills/calendly-api/agent", "manifestUrl": "https://openagent3.xyz/skills/calendly-api/agent.json", "briefUrl": "https://openagent3.xyz/skills/calendly-api/agent.md" } }