Create Nylas v3 virtual calendars to schedule resources (rooms, equipment) without a real mailbox account

domain: developer.nylas.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a virtual calendar connector, then a virtual account under that connector, before creating any virtual calendars.
  2. POST /v3/grants/{grant_id}/calendars with a name and description to create the calendar under the virtual account's grant.
  3. Note that the first virtual calendar created for a virtual account automatically becomes that account's primary calendar and cannot be changed later.
  4. Reference the primary virtual calendar in subsequent event calls using the literal string "primary" instead of its calendar_id, consistent with how real provider calendars are addressed.
  5. Use standard Events API calls (create/list/update) against the virtual calendar's grant_id/calendar_id exactly as you would for a real connected calendar, since virtual calendars share the same Events API surface.

Known gotchas

Related routes

Configure a Nylas v3 Scheduler booking page (configuration) for external guests to book time
developer.nylas.com · 5 steps · unrated
Create and manage Nylas v3 grants (OAuth connections) to authorize calendar access for a user
developer.nylas.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans