specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: Calendly
providerId: calendly
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-05'
reconciled: false
tags:
  - Scheduling
  - SaaS
  - Rate Limiting
description: 'Calendly applies request rate limits to the v2 Scheduling API and the Webhook API. The
  developer portal references rate limiting in its docs but the per-second / per-minute thresholds are
  served from a JavaScript-rendered Stoplight viewer that is not directly extractable; consumers should
  consult the live documentation for current numbers. Rate limits are scoped to the access token / OAuth
  application and apply across the production API. The Free plan does not include API access, so rate
  limits practically only affect Standard, Teams and Enterprise customers.'
sources:
  - https://developer.calendly.com/api-docs
  - https://developer.calendly.com/getting-started
  - https://calendly.stoplight.io/docs/api-docs
notes: |
  Specific per-second / per-minute thresholds are documented in Calendly's Stoplight-hosted reference
  but were not extractable from the public HTML at reconciliation time. Treat the limits below as a
  structural placeholder; replace with the published numbers when available.
responseCodes:
  throttled: 429
  quotaExceeded: 429
  serviceUnavailable: 503
limits:
  - name: Scheduling API requests
    scope: access-token
    metric: requests_per_minute
    limit: see developer.calendly.com Stoplight docs
    notes: Rate is bound to the OAuth access token / personal access token. Exceeding it returns HTTP 429.
  - name: Webhook delivery retries
    scope: subscription
    metric: retries_per_failed_event
    limit: see developer.calendly.com webhook docs
    notes: Calendly retries failed webhook deliveries with exponential backoff before disabling the subscription.
policies:
  - name: Token-Scoped Limits
    description: Rate limits are enforced per access token. OAuth applications should distribute calls
      across user tokens rather than concentrating them on a single service token.
  - name: Backoff on 429
    description: When HTTP 429 is observed, retry with exponential backoff and jitter. Do not loop tightly.
  - name: Webhook Retries
    description: Calendly retries failed webhook POSTs on a backoff schedule and eventually disables the
      subscription if the endpoint stays unreachable. Endpoints should respond 2xx promptly and process
      asynchronously.
  - name: Pagination Discipline
    description: Use cursor pagination on list endpoints rather than aggressive polling to stay well under
      the published ceiling.
maintainers:
  - FN: API Evangelist
    url: http://apievangelist.com
    email: info@apievangelist.com