Google Meet Link Creation

Google has two APIs for creating Meet links. One of them does not work for half your users, and the documentation never mentions it.

The Problem

I needed to create Google Meet links programmatically. The feature had to work for every user — free Gmail accounts and paid Google Workspace accounts alike. Google offers two APIs that can do this, and picking the wrong one cost me a day of debugging.

Options Considered

Option	Pros	Cons
Calendar API with conferenceData	Universal (Gmail + Workspace), battle-tested	Requires calendar write, create/delete overhead
Meet REST API (spaces.create)	Direct creation, more control	Workspace only - doesn’t work with free Gmail
Pre-generated Meet links	Simple	Not scalable, security concerns

The Critical Finding

The Google Meet REST API requires Google Workspace. Free Gmail accounts cannot call spaces.create. The API returns a permission error with no indication that account type is the issue.

I discovered this only after building a working integration against a Workspace test account. Switching to a free Gmail account for QA broke everything.

The Solution: Calendar API with conferenceData

The Calendar API approach creates a temporary calendar event with conference data attached, extracts the Meet link, then deletes the event. It sounds like a hack. It is the industry-standard approach.

// 1. Use the calendar's integration for OAuth
// 2. Create event with conferenceData
// 3. Extract Meet link
// 4. Delete temporary event
// 5. Return persistent Meet link (survives event deletion)

Why This Works

1. Universal Compatibility: Works with both free Gmail and paid Workspace accounts — no account-type gatekeeping
2. Meet link persists after event deletion: The meeting room remains accessible even after the temporary calendar event is deleted
3. Clear Ownership: Calendar owner becomes meeting host, and calendar write access maps to meeting creation rights
4. Minimal Overhead: Create event, extract link, delete event — three API calls that complete in under a second

What I Learned About Rate Limits

Both APIs are free to use. The Calendar API has generous quotas for this pattern. One thing to know: free Gmail accounts impose a 60-minute limit on meetings with 3+ participants.

Clearing Meet Links (conferenceData = null)

Later, I needed to remove a Meet link from an existing event. This turned into its own debugging session.

hangoutLink is read-only in Google Calendar API — it is derived from conferenceData. You cannot set it directly. To remove a Meet link, you must send conferenceData: null with conferenceDataVersion: 1.

Three-State Semantics

The API interprets conferenceData differently depending on its value and whether conferenceDataVersion is set:

conferenceData value	conferenceDataVersion	Google behavior
{...} (truthy)	1	Set/update conference data
null	1	Clear conference data (removes Meet link)
undefined (omitted)	0	Ignore — preserve existing conference data

The Silent Failure Trap

Without conferenceDataVersion: 1, Google silently ignores all conference changes. The API returns 200 OK. The response looks normal. But nothing changes.

This makes clearing bugs particularly hard to diagnose. You think your code is working — the API said so — but the Meet link is still there.

TypeScript Type Gap

Google’s googleapis npm types define conferenceData as Schema$ConferenceData | undefined — there is no null in the union. But the REST API does accept null to clear conference data. The workaround requires a type assertion:

// Google's types don't model null for request semantics
(event as Record<string, unknown>).conferenceData = null;

This is one of those cases where the TypeScript types and the actual API semantics disagree. The REST API documentation is the source of truth.

Key Takeaways

1. Check account type requirements first — APIs may have different capabilities for free vs paid accounts. Test with both before committing to an approach.

2. “New and shiny” is not always better — The Meet REST API (released Feb 2024) seemed ideal but had a deal-breaking limitation that the older Calendar API approach does not.

3. Workarounds can be permanent solutions — Creating and deleting a temporary event feels wrong, but it is what Google themselves recommend.

4. Silent 200 OK responses lie — When conferenceDataVersion is missing, Google accepts your request and does nothing. Always verify state changes against a follow-up read.

5. Type definitions lag behind API reality — When official types do not model a valid API state (like null for clearing), check the REST documentation and use a targeted type assertion.