Nylas

aid: nylas
name: Nylas
description: Nylas connects your application to every email inbox and calendar in the world. The Nylas v3 platform provides
  REST APIs for email, calendar, contacts, scheduling, meeting notetaking, authentication, and administration across Google,
  Microsoft, Exchange, iCloud, Yahoo and any IMAP provider. Official SDKs cover Node.js, Python, Ruby and Kotlin/Java, alongside
  a CLI, a hosted MCP server, and Agent Accounts that provision a Nylas-hosted mailbox and calendar for autonomous agents
  without requiring an OAuth flow.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/nylas.png
tags:
- Calendar
- Communications
- Contacts
- Email
- Messaging
- Scheduling
tags_raw:
- Calendar
- Communication
- Contacts
- Email
- Messaging
- Scheduling
created: '2025-02-06'
modified: '2026-04-28'
url: https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/apis.yml
specificationVersion: '0.23'
apis:
- aid: nylas:nylas-api
  name: Nylas API
  description: The Nylas v3 REST API provides programmatic access to email, calendar, contacts, meeting notetaking, scheduling,
    authentication and administration across Google, Microsoft, Exchange, iCloud, Yahoo and any IMAP provider. Resources are
    scoped to a grant, which represents one authenticated mailbox and calendar. The entries below are facets of this single
    contract.
  humanURL: https://developer.nylas.com/
  baseURL: https://api.us.nylas.com
  tags:
  - Calendar
  - Communications
  - Contacts
  - Email
  - Messaging
  - Scheduling
  tags_raw:
  - Calendar
  - Communication
  - Contacts
  - Email
  - Messaging
  - Scheduling
  properties:
  - type: OpenAPI
    url: https://developer.nylas.com/_spec-files/nylas-api.yaml
  - type: Documentation
    url: https://developer.nylas.com/docs/
  - type: APIReference
    url: https://developer.nylas.com/docs/reference/api/
  - type: GettingStarted
    url: https://developer.nylas.com/docs/v3/getting-started/
  - type: Authentication
    url: https://developer.nylas.com/docs/v3/auth/
  - type: RateLimits
    url: https://developer.nylas.com/docs/dev-guide/platform/rate-limits/
  - type: ErrorCodes
    url: https://developer.nylas.com/docs/api/errors/
  - type: Pricing
    url: https://www.nylas.com/pricing/
  - type: Signup
    url: https://dashboard-v3.nylas.com/register
  - type: StatusPage
    url: https://status.nylas.com/
  - type: SDKs
    name: Node.js SDK
    url: https://github.com/nylas/nylas-nodejs
  - type: SDKs
    name: Python SDK
    url: https://github.com/nylas/nylas-python
  - type: SDKs
    name: Ruby SDK
    url: https://github.com/nylas/nylas-ruby
  - type: SDKs
    name: Java/Kotlin SDK
    url: https://github.com/nylas/nylas-java
- aid: nylas:nylas-admin-api
  name: Nylas Admin API
  description: 'Application-level administration: Nylas applications, API keys, custom domains, connectors and connector credentials,
    workspaces, and the rules, policies and lists that govern them.'
  humanURL: https://developer.nylas.com/docs/reference/api/applications/
  baseURL: https://api.us.nylas.com
  tags:
  - Admin
  properties:
  - type: OpenAPI
    url: openapi/nylas-admin-api-openapi.yml
- aid: nylas:nylas-auth-api
  name: Nylas Auth API
  description: Authentication. Hosted OAuth 2.1 authorization and token exchange, custom (non-OAuth) grant creation for Agent
    Accounts, token refresh and revocation, and ID token validation.
  humanURL: https://developer.nylas.com/docs/reference/api/authentication-apis/
  baseURL: https://api.us.nylas.com
  tags:
  - Authentication
  tags_raw:
  - Auth
  properties:
  - type: OpenAPI
    url: openapi/nylas-auth-api-openapi.yml
- aid: nylas:nylas-calendars-api
  name: Nylas Calendars API
  description: Calendars. List and manage a grant's calendars, query free/busy availability across participants, and read
    room and resource calendars.
  humanURL: https://developer.nylas.com/docs/reference/api/calendar/
  baseURL: https://api.us.nylas.com
  tags:
  - Calendars
  properties:
  - type: OpenAPI
    url: openapi/nylas-calendars-api-openapi.yml
- aid: nylas:nylas-contacts-api
  name: Nylas Contacts API
  description: Contacts. Read, create, update and delete a grant's contacts and contact groups.
  humanURL: https://developer.nylas.com/docs/reference/api/contacts/
  baseURL: https://api.us.nylas.com
  tags:
  - Contacts
  properties:
  - type: OpenAPI
    url: openapi/nylas-contacts-api-openapi.yml
- aid: nylas:nylas-drafts-api
  name: Nylas Drafts API
  description: Drafts. Compose, update, send and delete drafts, manage attachments, and generate draft bodies and replies
    with Smart Compose.
  humanURL: https://developer.nylas.com/docs/reference/api/drafts/
  baseURL: https://api.us.nylas.com
  tags:
  - Drafts
  properties:
  - type: OpenAPI
    url: openapi/nylas-drafts-api-openapi.yml
- aid: nylas:nylas-events-api
  name: Nylas Events API
  description: Events. Create, update, delete and list calendar events, including recurring events, group events and RSVP
    handling.
  humanURL: https://developer.nylas.com/docs/reference/api/events/
  baseURL: https://api.us.nylas.com
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/nylas-events-api-openapi.yml
- aid: nylas:nylas-grants-api
  name: Nylas Grants API
  description: Grants. A grant represents one authenticated mailbox and calendar. List, retrieve and delete grants, and inspect
    grant state and scopes.
  humanURL: https://developer.nylas.com/docs/reference/api/manage-grants/
  baseURL: https://api.us.nylas.com
  tags:
  - Grants
  properties:
  - type: OpenAPI
    url: openapi/nylas-grants-api-openapi.yml
- aid: nylas:nylas-messages-api
  name: Nylas Messages API
  description: Messages. List, search, read, update and delete email messages. Send immediately, schedule a send and cancel
    a scheduled send, with folders, signatures and attachments alongside.
  humanURL: https://developer.nylas.com/docs/reference/api/messages/
  baseURL: https://api.us.nylas.com
  tags:
  - Message
  tags_raw:
  - Messages
  properties:
  - type: OpenAPI
    url: openapi/nylas-messages-api-openapi.yml
- aid: nylas:nylas-scheduling-api
  name: Nylas Scheduling API
  description: Scheduler. Booking configurations, scheduling sessions, availability lookups and booking lifecycle management
    for hosted and component-based booking flows.
  humanURL: https://developer.nylas.com/docs/reference/api/configurations/
  baseURL: https://api.us.nylas.com
  tags:
  - Scheduling
  properties:
  - type: OpenAPI
    url: openapi/nylas-scheduling-api-openapi.yml
- aid: nylas:nylas-threads-api
  name: Nylas Threads API
  description: Threads. List, search, read and update email threads, and manage thread-level folders and state.
  humanURL: https://developer.nylas.com/docs/reference/api/threads/
  baseURL: https://api.us.nylas.com
  tags:
  - Threads
  properties:
  - type: OpenAPI
    url: openapi/nylas-threads-api-openapi.yml
- aid: nylas:nylas-notifications-api
  name: Nylas Notifications API
  description: 'Change notifications. Nylas pushes events for messages, threads, calendars, events, grants and Notetaker over
    three interchangeable transports carrying the same payloads: HTTPS webhooks, Google Cloud Pub/Sub, and Amazon SNS. Covers
    subscription CRUD, delivery testing, mock payloads and the source IP ranges to allowlist. There is no polling requirement,
    and no WebSocket or SSE surface.'
  humanURL: https://developer.nylas.com/docs/reference/notifications/
  baseURL: https://api.us.nylas.com
  tags:
  - Webhooks
  - Notifications
  - Event
  tags_raw:
  - Webhooks
  - Notifications
  - Events
  properties:
  - type: OpenAPI
    url: openapi/nylas-notifications-api-openapi.yml
  - type: APIReference
    url: https://developer.nylas.com/docs/reference/notifications/
  - type: Documentation
    url: https://developer.nylas.com/docs/v3/notifications/
- aid: nylas:nylas-notetaker-api
  name: Nylas Notetaker API
  description: Meeting notetaker. Send a notetaker to a Google Meet, Microsoft Teams or Zoom call, then retrieve the recording,
    transcript, summary and action items. Available grant-scoped, or standalone with no connected mailbox required.
  humanURL: https://developer.nylas.com/docs/reference/api/notetaker/
  baseURL: https://api.us.nylas.com
  tags:
  - Notetaker
  - Transcription
  - Meetings
  properties:
  - type: OpenAPI
    url: openapi/nylas-notetaker-api-openapi.yml
  - type: APIReference
    url: https://developer.nylas.com/docs/reference/api/notetaker/
  - type: Documentation
    url: https://developer.nylas.com/docs/v3/notetaker/
- aid: nylas:nylas-templates-workflows-api
  name: Nylas Templates and Workflows API
  description: Reusable email templates and automation workflows, at both application and grant scope. Define a template once
    and send against it, or trigger a workflow on an inbound event.
  humanURL: https://developer.nylas.com/docs/reference/api/application-level-templates/
  baseURL: https://api.us.nylas.com
  tags:
  - Templates
  - Workflows
  - Automation
  properties:
  - type: OpenAPI
    url: openapi/nylas-templates-workflows-api-openapi.yml
  - type: APIReference
    url: https://developer.nylas.com/docs/reference/api/application-level-templates/
common:
- type: AgenticAccess
  url: agentic-access/nylas-agentic-access.yml
- type: TrustCenter
  url: security/nylas-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/nylas-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/nylas-domain-security.yml
- type: Authentication
  url: authentication/nylas-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/nylas
- type: Website
  url: https://www.nylas.com/
- type: Documentation
  url: https://developer.nylas.com/
- type: Blog
  url: https://www.nylas.com/blog/
- type: GitHubOrg
  url: https://github.com/nylas
- type: TermsOfService
  url: https://www.nylas.com/legal/terms/
- type: PrivacyPolicy
  url: https://www.nylas.com/legal/privacy-policy/
- type: StatusPage
  url: https://status.nylas.com/
- type: LlmsText
  url: https://developer.nylas.com/llms.txt
- type: DeveloperPortal
  url: https://developer.nylas.com/
- type: APIReference
  url: https://developer.nylas.com/docs/reference/api/
- type: APIReference
  name: Notifications reference
  url: https://developer.nylas.com/docs/reference/notifications/
- type: APIReference
  name: UI components reference
  url: https://developer.nylas.com/docs/reference/ui/
- type: GettingStarted
  url: https://developer.nylas.com/docs/v3/getting-started/
- type: SDKs
  name: Node.js SDK
  url: https://github.com/nylas/nylas-nodejs
- type: SDKs
  name: Python SDK
  url: https://github.com/nylas/nylas-python
- type: SDKs
  name: Ruby SDK
  url: https://github.com/nylas/nylas-ruby
- type: SDKs
  name: Java/Kotlin SDK
  url: https://github.com/nylas/nylas-java
- type: CLI
  url: https://cli.nylas.com/
- type: Postman
  url: https://developer.nylas.com/docs/v3/api-references/postman/
- type: PostmanWorkspace
  url: https://www.postman.com/trynylas/workspace/nylas-api/overview
- type: AgentSkills
  url: https://developer.nylas.com/.well-known/agent-skills/index.json
- type: Support
  url: https://developer.nylas.com/docs/support/
- type: ChangeLog
  url: https://developer.nylas.com/docs/changelogs/
- type: DeprecationPolicy
  url: https://developer.nylas.com/docs/support/product-lifecycle/
- type: Security
  url: https://www.nylas.com/security/
- type: Compliance
  url: https://trust.nylas.com/public
- type: Webhooks
  url: https://developer.nylas.com/docs/v3/notifications/
- type: ErrorCodes
  url: https://developer.nylas.com/docs/api/errors/
- type: RateLimits
  url: https://developer.nylas.com/docs/dev-guide/platform/rate-limits/
- type: Idempotency
  url: https://developer.nylas.com/docs/v3/email/idempotent-send/
- type: Pricing
  url: https://www.nylas.com/pricing/
- type: Signup
  url: https://dashboard-v3.nylas.com/register
- type: MCPServer
  name: Nylas MCP Server
  url: https://mcp.us.nylas.com
- type: MCPServer
  name: Nylas MCP Server manifest
  url: mcp/nylas-mcp.yml
- type: Vocabulary
  url: vocabulary/nylas-vocabulary.yml
- type: Conformance
  url: conformance/nylas-conformance.yml
- type: AgentCard
  url: a2a/nylas-a2a.yml
- type: SecurityTxt
  url: https://developer.nylas.com/.well-known/security.txt
- type: ContentSignal
  url: https://developer.nylas.com/robots.txt
- type: APICatalog
  url: https://developer.nylas.com/.well-known/api-catalog
- type: WellKnown
  url: well-known/nylas-well-known.yml
x-provenance:
  provider_published: true
  summary: The artifacts in this repository were authored by Nylas and submitted as api-evangelist/nylas#1, then verified
    by API Evangelist against live URLs before merge. The contract registered below is Nylas' own published document, harvested
    verbatim.
  submitted_by:
    name: Nick Barraclough
    role: Developer documentation, Nylas
    pull_request: https://github.com/api-evangelist/nylas/pull/1
  api_evangelist_changes:
  - Harvested the published contract from https://developer.nylas.com/_spec-files/nylas-api.yaml to openapi/_original/nylas-api-openapi.yml
    (sha256 7ff001d571e163b1ffe22178741b59f813d8208ec878157a839a33dc2c13fd35) and split it into the 13 domain specs the provider's
    own entries name. The PR pointed all fourteen entries at the remote URL, which would have left every local spec unregistered
    and deleted on the next rebuild, and left a 1.67 MB contract to be read through a 32 KB embedded-source cap.
  - Quarantined eleven API Evangelist scaffolds to openapi/_scaffold/ and stamped each one. They were derived from reading
    developer.nylas.com/docs/ and said so in their own info.description, but carried no provenance marker, so the rubric had
    been crediting 22 modelled operations at full first-party weight while the provider's real 208-operation contract went
    uncounted. The provider identified this from the outside.
  - Hoisted `servers:` above `info:` in every emitted document. Semantically inert -- a YAML mapping is unordered -- but Nylas'
    info.description is a single ~20 KB line carrying an embedded Postman payload, which pushed the servers block past the
    24 KB head window the provenance indexer reads. All thirteen splits registered as no_servers until this.
  verified:
    date: '2026-08-21'
    contract: 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. Counted from the harvested document, not from the submission.
    also_confirmed: 'All five .well-known paths, both MCP endpoints (401, live and auth-gated), all published rate limits,
      and the trust-center compliance list. The provider''s disclosed negatives were confirmed as negatives: no A2A protocolVersion
      on the agent card, no webhooks object, and Idempotency-Key on exactly 2 of 95 mutating operations.'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com