Nylas

Nylas Events API

Events. Create, update, delete and list calendar events, including recurring events, group events and RSVP handling.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/grants/{grant_id}/events List events on a user's calendar · Return all events #
Ask an LLM
“How do I list upcoming events on a connected user's calendar?”
“Can I expand recurring events into individual occurrences when listing?”
Tell an agent
List events on calendar {calendar_id} for {grant_id}.
Show events on {calendar_id} in {grant_id} between {start} and {end}.
POST /v3/grants/{grant_id}/events Create a calendar event · Create an event #
Ask an LLM
“How do I put a new meeting on someone's calendar?”
“Can I add participants and conferencing details when creating an event?”
Tell an agent
Create an event {title} on calendar {calendar_id} for {grant_id} at {when}.
Schedule a meeting on {calendar_id} in {grant_id} at {when} and invite {participants}.
GET /v3/grants/{grant_id}/events/import Import all events from a calendar for syncing · Import events #
Ask an LLM
“What's the best way to pull every event, including recurring exceptions, into my own database?”
“Can I import a calendar's events for a time frame to sync them to my app?”
Tell an agent
Import events from calendar {calendar_id} for grant {grant_id}.
Import every event on {calendar_id} in {grant_id} from {start} to {end} for sync.
GET /v3/grants/{grant_id}/events/{event_id} Retrieve a single calendar event · Return an event #
Ask an LLM
“How can I get the details of one specific calendar event?”
“Can I fetch a single event by ID to check its time and participants?”
Tell an agent
Get event {event_id} from calendar {calendar_id} for {grant_id}.
Show the details of meeting {event_id} on {calendar_id} in grant {grant_id}.
PUT /v3/grants/{grant_id}/events/{event_id} Update or reschedule a calendar event · Update an event #
Ask an LLM
“How do I reschedule an existing calendar event to a new time?”
“Can I change the title or location of an event that's already on the calendar?”
Tell an agent
Move event {event_id} on {calendar_id} in {grant_id} to {when}.
Change the location of event {event_id} on {calendar_id} for {grant_id} to {location}, keeping it at {when}.
DELETE /v3/grants/{grant_id}/events/{event_id} Delete a calendar event · Delete an event #
Ask an LLM
“How do I remove a meeting from a user's calendar?”
“Can I delete an event without notifying the participants?”
Tell an agent destructive · confirm first
Delete event {event_id} from calendar {calendar_id} for {grant_id}.
Remove meeting {event_id} on {calendar_id} in grant {grant_id} without notifying anyone.
POST /v3/grants/{grant_id}/events/{event_id}/send-rsvp Respond yes, no or maybe to an event invite · Send RSVP #
Ask an LLM
“How do I accept or decline a meeting invitation on a user's behalf?”
“Can I RSVP maybe to an event I've been invited to?”
Tell an agent
RSVP {status} to event {event_id} on calendar {calendar_id} for {grant_id}.
Decline invite {event_id} on {calendar_id} for grant {grant_id}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/json-schema/nylas-event-create-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nylas:nylas-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nylas-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nylas Events API
  version: v3
  summary: The complete Nylas v3 API — Email, Calendar, Contacts, Notetaker, Scheduling, Administration, and Migration.
  description: The Nylas API is designed using the REST ideology to provide simple and predictable URIs to access and modify objects.
  contact:
    url: https://www.nylas.com/
  x-provenance:
    method: harvested
    first_party: true
    publisher: Nylas
    source: https://developer.nylas.com/_spec-files/nylas-api.yaml
    harvested: '2026-08-21'
    sha256: 7ff001d571e163b1ffe22178741b59f813d8208ec878157a839a33dc2c13fd35
    bytes: 1666223
    note: 'Published by Nylas as the unified contract for the Nylas v3 API and stored verbatim; API Evangelist added only this provenance block. Submitted by the provider in api-evangelist/nylas#1 and verified against the live URL before harvest: OpenAPI 3.1.0, 118 paths, 208 operations, 174 component schemas, 100% of operations carrying summary, description, tag and a unique operationId, x-code-samples on 208 of 208. This document REPLACES a 22-operation scaffold API Evangelist derived from reading the documentation, now quarantined under openapi/_scaffold/.'
  x-evidence:
  - url: https://developer.nylas.com/_spec-files/nylas-api.yaml
    what: the published unified contract, harvested verbatim 2026-08-21 (200, text/yaml, 1,666,223 bytes)
  - url: https://developer.nylas.com/.well-known/api-catalog
    what: RFC 9727 linkset advertising that URL as service-desc for api.us.nylas.com and api.eu.nylas.com (200, application/linkset+json)
servers:
- url: https://api.us.nylas.com
  description: U.S.
- url: https://api.eu.nylas.com
  description: E.U.
security:
- ACCESS_TOKEN: []
- NYLAS_API_KEY: []
tags:


# --- truncated at 32 KB (118 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-events-api-openapi.yml