Skip to content

savvycal.md

Latest commit

 

History

History
181 lines (129 loc) · 3.36 KB

savvycal.md

File metadata and controls

181 lines (129 loc) · 3.36 KB

SavvyCal

Scheduling platform API for managing scheduling links, events, availability slots, and webhooks.

Capabilities

Integration Available Notes
API ✓ REST API v1 - scheduling links, events, webhooks
MCP - Not available
CLI ✓ savvycal.js
SDK - No official SDK

Authentication

  • Type: Bearer Token (Personal Access Token or OAuth 2.0)
  • Header: Authorization: Bearer {token}
  • Get key: Developer Settings in SavvyCal dashboard (create a Personal Access Token)

Common Agent Operations

Get current user

GET https://api.savvycal.com/v1/me

List scheduling links

GET https://api.savvycal.com/v1/scheduling-links

Get a scheduling link

GET https://api.savvycal.com/v1/scheduling-links/{id}

Create a scheduling link

POST https://api.savvycal.com/v1/scheduling-links

{
  "name": "30 Minute Meeting",
  "slug": "30min",
  "duration_minutes": 30
}

Update a scheduling link

PATCH https://api.savvycal.com/v1/scheduling-links/{id}

{
  "name": "Updated Meeting Name"
}

Delete a scheduling link

DELETE https://api.savvycal.com/v1/scheduling-links/{id}

Duplicate a scheduling link

POST https://api.savvycal.com/v1/scheduling-links/{id}/duplicate

Toggle link state (active/disabled)

POST https://api.savvycal.com/v1/scheduling-links/{id}/toggle

Get available time slots

GET https://api.savvycal.com/v1/scheduling-links/{id}/slots

List events

GET https://api.savvycal.com/v1/events

Get an event

GET https://api.savvycal.com/v1/events/{id}

Create an event

POST https://api.savvycal.com/v1/events

{
  "scheduling_link_id": "{link_id}",
  "start_at": "2024-01-20T10:00:00Z",
  "name": "John Doe",
  "email": "john@example.com"
}

Cancel an event

POST https://api.savvycal.com/v1/events/{id}/cancel

List webhooks

GET https://api.savvycal.com/v1/webhooks

Create a webhook

POST https://api.savvycal.com/v1/webhooks

{
  "url": "https://example.com/webhook",
  "events": ["event.created", "event.canceled"]
}

Key Metrics

Scheduling Link Data

  • id - Unique link identifier
  • name - Display name
  • slug - URL slug
  • duration_minutes - Meeting duration
  • state - Active or disabled
  • url - Full scheduling URL

Event Data

  • id - Unique event identifier
  • name - Invitee name
  • email - Invitee email
  • start_at / end_at - Event timing
  • status - Event status
  • scheduling_link - Associated scheduling link

Parameters

List Events

  • before / after - Pagination cursors
  • limit - Results per page (default 20, max 100)

List Scheduling Links

  • before / after - Pagination cursors
  • limit - Results per page

When to Use

  • Managing scheduling links programmatically
  • Retrieving booked events for CRM or analytics sync
  • Checking available time slots for custom booking UIs
  • Automating scheduling link creation for campaigns
  • Monitoring booking activity via webhooks

Rate Limits

  • Not officially documented
  • Implement retry logic with exponential backoff
  • Monitor for HTTP 429 responses

Relevant Skills

  • lead-generation
  • sales-automation
  • appointment-scheduling
  • customer-onboarding