Skip to main content

Calendly Integration

Setup Calendly integration effortlessly and get valuable insights

M
Written by Marta Droneva
Updated over 2 weeks ago

Connect your Calendly organisation to Viio and get clear insight into members, real activity, and licence usage—so you only pay for seats you need.

Capabilities

Capability

What it means in Viio

Users

Syncs every active Calendly member so you can map ownership and cost.

Usage

Pulls the Last scheduled event date for each user to surface dormant accounts.

Prerequisites

  • Calendly Professional, Teams, or Enterprise plan (API access is limited on the free plan).

  • You must be an Owner or Admin in Calendly to generate the token.

  • Generate a Personal Access Token from Calendly → Integrations → API & Webhooks.

  • If your organisation restricts external apps, whitelist https://app.viio.io.

Setup

  1. Go to Viio → Integrations and choose Calendly.

  2. In a new browser tab, open Calendly → Integrations → API & Webhooks and select Get a token now (or Generate new token).

  3. Give the token a name (e.g. Viio sync) and click Create Token.

  4. Copy the token—Calendly shows it only once.

  5. Back in Viio, paste the token into the API Token field.

  6. Click Validate. If the test succeeds, select Install to start the first sync.

  7. Wait a few minutes; Viio will notify you when the initial import is complete.

Troubleshooting & FAQ

Issue

How to resolve

“Invalid token” error

Make sure you copied the full token with no extra spaces and that the creator is still an Owner or Admin.

No data after first sync

Verify the token is still active under API & Webhooks → Your personal access tokens and hasn’t expired.

Seats don’t match Calendly billing portal

Calendly counts all active members; Viio ignores members set to Inactive. Re‑enable or delete duplicates.

Activity looks outdated

Viio bases activity on the user’s last scheduled or hosted event. If a user only hosts infrequently, this can lag.

Technical Details

  • Auth method: Personal Access Token (admin/owner scopes).

  • Scopes requested: full read access (organization.read, users.read, scheduled_events.read).

  • Key endpoints called (Calendly REST API v2):

    • GET /users – fetch members

    • GET /organization – seat and licence data

    • GET /scheduled_events?organization_uri=... – pull event dates for last‑seen calculation

  • Viio operates read‑only; it never creates, edits, or deletes Calendly data.

  • Data refresh cadence: every 24 hours

Additional resources


Need more help? Chat with Viio Support or email [email protected].

Write something...


Did this answer your question?