Skip to main content
Get a preview
All docs

Connect Cal.com

Cal.com is the preferred first scheduling source. Porchlight owns qualification and booking logic, while Cal.com remains the source of truth for real availability.

What you need

  • A Cal.com account.
  • A Cal.com API key with access to event types.
  • One event type for the next step Porchlight should book: consult, showroom visit, design call, or site visit.

If you have not created the event type yet, create one in Cal.com under Event Types -> New. Name it clearly, such as Backyard project consult or Site visit.

Getting your API key

  1. Sign in to Cal.com.
  2. Go to Settings -> Developer -> API keys.
  3. Create an API key and copy the value.

API keys are sensitive. Porchlight stores them encrypted at rest.

Connecting in Porchlight

  1. Open Settings -> Integrations.
  2. Find Cal.com.
  3. Paste the API key.
  4. Pick the event type Porchlight should use.
  5. Save.

How the agent uses it

When a buyer is ready, the agent:

  1. Pulls real availability.
  2. Offers a few natural time options.
  3. Confirms name and email.
  4. Books the appointment.
  5. Attaches the buyer context, transcript link, project summary, budget, timeline, and site-readiness notes.

Calendar strategy

Cal.com comes first because it is fast to wire and clean to operate. Google Calendar is next, Outlook later, and a lightweight Porchlight availability fallback can cover customers without a usable calendar.

Troubleshooting

If the agent cannot find slots, check the event type, availability rules, buffers, and future booking limits in Cal.com.

If bookings do not appear in the underlying calendar, confirm Cal.com is connected to Google, iCloud, or Outlook and that calendar sync is enabled.

If scheduling should be disabled, disconnect Cal.com in Settings -> Integrations. Porchlight will route ready buyers to the follow-up queue instead.