← All articles
Developer API, MCP and webhooks·

Set up Getwello with Apple Calendar

Mirror Getwello visits into iCloud Calendar. Show on iPhone, iPad, Mac, watch.

Apple Calendar (iCloud) doesn't accept webhooks directly. Use Zapier's iCloud Calendar action, or push via CalDAV. Both routes produce events that show on every Apple device.

What you need

  • An iCloud account.
  • A Zapier account (free tier is fine), or comfort with CalDAV.
  • A Getwello Coordinator account with active subscription.

Step 1: Create the iCloud calendar

  1. On Mac or iPhone, open Calendar.
  2. File → New Calendar → iCloud. Name it “Mum visits”.
  3. Right-click the calendar → Share Calendar. Add family emails.

Step 2 (Route A): via Zapier

  1. In Zapier: Create Zap, trigger Webhooks → Catch Hook.
  2. Action: Apple iCloud Calendar → Create Event.
  3. Generate an app-specific password for Zapier (account.apple.com → Sign-in security → App-Specific Passwords).
  4. Map fields (summary, start, end, calendar).

Step 2 (Route B): via CalDAV

iCloud speaks CalDAV at caldav.icloud.com. A small worker can POST iCal-format events directly. Cleaner but more code.

Step 3: Create the Getwello webhook subscription

Settings → Developer API → Webhooks. URL is the Zapier Catch Hook or your CalDAV relay. Tick visit.created.

Test

Schedule a sample visit. Watch it appear on every Apple device the family shares the calendar with.

Troubleshooting

Zapier auth fails: use an app-specific password, not your iCloud password. iCloud blocks regular password access for third-party apps.

Time zones drift: double-check that the start/end timestamps include time zone offsets, not naked local times.

More on developer api, mcp and webhooks

Didn't answer your question?

Email hello@getwello.co.uk