Skip to content
Skip to main content

All changelogs

Agent Account metadata
Agent Account metadataAgent AccountsEmailCalendar

Agent Account grants now support the metadata object on Events, Messages, and Drafts. Attach up to 50 key-value pairs per object and filter by the five reserved keys with metadata_pair, the same way connected grants do.

Agent Accounts in Scheduler
Agent Accounts in SchedulerAgent AccountsSchedulerCalendar

Agent Account grants can now own a Scheduler Configuration and act as the organizer, so an agent hands out its own booking link and takes bookings on its own calendar. Round-robin Configurations and non-primary calendars aren't supported yet.

iCloud CalDAV error code fix

iCloud CalDAV requests that fail with an authorization error now correctly return a 403 Forbidden response instead of a 504 Gateway Timeout, making permission issues easier to distinguish from timeouts.

Notetaker transcript fix

Fixed an issue where the Notetaker media endpoint reported no transcript available for a small number of meetings that already had a transcript.

Calendar owner_email field

The Calendar object now includes an owner_email field on Microsoft grants, naming the account that owns each calendar. Use it with is_owned_by_user to tell a user's own calendars apart from the ones shared with them.

CLI v3.1.30

Adds nylas email subscriptions commands to discover newsletter and mailing-list subscriptions from List-Unsubscribe headers, preview and open their unsubscribe actions, and clean up matching messages, for Google and Microsoft grants.

Java SDK v2.18.1

Adds TrackingOptions.domainName to send with a custom tracking domain for link and open tracking, and fixes attendees and anyEmail filters silently keeping only the last value when multiple values were passed.

Agent Account message headers

Agent Account grants now support both fields header options. Read the full header set with fields=include_headers, or just Message-ID, In-Reply-To, and References with fields=include_basic_headers, on message get and send requests.

@nylas/web-elements v2.5.17

Fixes the scheduler showing a misleading API request failed error after a booking was successfully cancelled, even though the cancellation succeeded.

Agent Account email search
Agent Account email searchAgent AccountsEmail

Agent Account grants now support full-text search on the Messages and Threads endpoints. One relevance-ranked query searches subjects, participants, visible body text, and attachment filenames with Boolean operators, quoted phrases, grouping, and negation.

Scheduler change attribution

New: Scheduler now stamps scheduler_last_start, scheduler_last_end, and scheduler_updated_at metadata on the events it books. Compare them against event.updated payload times to tell Scheduler reschedules apart from direct calendar edits.

Notetaker keyword hints
Notetaker keyword hintsNotetakerCalendar

New: Notetaker transcription_settings now accepts keywords and use_speaker_names_as_keywords to bias transcription toward names, acronyms, and product names it would otherwise mis-hear. Language and keyword hints are independent.

Node.js SDK v8.4.0

Adds nylas.transactionalSend.send() for domain-based transactional email, plus calendarId and eventId on the Notetaker model. Fixes the WebhookTriggers enum with truncated message triggers and a batch of previously missing trigger types, and bumps dependencies to their latest versions.

Ruby SDK v6.8.0

Adds admin API resources — Policies, Rules, Lists, Workspaces, and Domains — plus Applications update support and request body support on DELETE.

Agent Accounts (GA)
Agent Accounts (GA)Agent AccountsEmailCalendar

Agent Accounts are now generally available. Provision a dedicated name@yourdomain.com mailbox and calendar for an AI agent with a single API call, guardrail it with Policies, Rules, and Lists, and run it against every standard Nylas endpoint.

Node.js SDK v8.3.0

Adds the htmlAsMarkdown option to messages.clean(), plus the typed Workspaces, Agent Account Lists, and Manage Domains admin APIs and an icalUid event filter from v8.2.0. Fixes Applications and Rules field naming, the Rules list response envelope, and enables field-set reduction in threads.find().

Python SDK v6.16.0

Adds application and workspace admin APIs (applications.update() and Workspaces CRUD), callback URI support in application updates, and Microsoft Graph large attachment upload sessions. Fixes the JSON Content-Type header so draft and other JSON requests aren't rejected.

Java SDK v2.17.0

Adds application administration to the SDK: Applications.update(), Manage Domains admin CRUD with Nylas Service Account signing, and a Workspaces resource. Introduces transactional email via Domains.sendTransactionalEmail(), plus app-level Policies, Rules, and Lists resources for Agent Accounts.

Headers on Send + include_basic_headers

Get RFC threading headers on the Send Message response without a follow-up GET call. A new fields=include_basic_headers option returns just Message-ID, In-Reply-To, and References — across List Messages, Get Message, and Send Message — for a much smaller payload than the full header set.

Node.js SDK v8.1.2

Adds a Node-native stream helper for attachment downloads and a typed `fields` query parameter on `messages.send()` that returns response headers.

Node.js SDK v8.1.1

Fixes camelCase metadata keys being silently snake_cased on the multipart form-data path used for large send and draft payloads.

Java SDK v2.16.0

Expands the events resource with resources, textDescription, multi-event-type filtering, and select/tentativeAsBusy query params. Adds metadata_pair filtering on list messages, Google Calendar color_id, and expanded notetaker meeting settings. Fixes events-exception parsing, thread ID encoding, scheduler participant defaults, and folder deserialization with select.

Node.js SDK v8.1.0

Adds typed support for Agent Accounts (Policies, Rules, Lists, and the new provider: 'nylas' BYO Auth variant) and resumable upload sessions for large attachments up to 150 MB on Microsoft grants.

Sandbox auth security screen

Sandbox apps now show a security notice in the hosted auth flow before users grant access. The screen highlights the permissions being requested and gives users a one-click path to report the application to the Nylas security team. Production, Staging, Development, and Shared GCP App flows are unchanged.

Notetaker language hints
Notetaker language hintsNotetakerCalendar

New: Notetaker now accepts transcription_settings to force a language or narrow what automatic language detection considers — useful when your users consistently speak one or more languages and auto-detect has been mis-identifying them. Transcripts also return the detected language code.

Idempotent send

Send endpoints now accept an Idempotency-Key header so retries don't deliver duplicate emails. Pass a unique key per logical send and Nylas caches the response for 1 hour — safe for workflow engines, background queues, and any client that retries after a network blip.

@nylas/web-elements v2.5.5

Fixes scheduler date and time slot clicks when auth props are set after mount, and restores the schedulerApiUrl region on full page refresh in React.

Python SDK v6.15.0

Adds Transactional Send, Manage Domains with service account request signing, and the Policies, Rules, and Lists APIs for Agent Accounts. Fixes camelCase query params on list grants.

Large attachments (Beta)

Send email attachments up to 150MB on Microsoft (Outlook and Exchange Online) grants using a new pre-upload flow. Upload the file once, then reference it by ID when sending.

Outbound rules
Outbound rulesAgent AccountsEmail

You can now restrict what your Agent Accounts send. Block sends to specific recipients, domains, or TLDs before they reach the provider — so an autonomous agent can't email the wrong address on its own.

Agent Accounts (Beta)
Agent Accounts (Beta)Agent AccountsEmailCalendar

Agent Accounts are Nylas-hosted email and calendar identities that an AI agent owns end-to-end. Create a real name@company.com mailbox through the API, assign policies and rules to guardrail its behavior, and use every existing Nylas endpoint against the new grant.

Webhook and notification updates

Compressed webhook delivery for webhooks, SNS, and Pub/Sub; a new message.created.cleaned trigger for Clean Conversations; and a field-name correction on the IMAP sync completed notification.

API Reference

Updated OpenAPI specs to correctly document nullable fields across Scheduler, Events, Contacts, Availability, Free/Busy, and Attachments APIs.

Email Signatures

New Signatures API lets you create, store, and manage reusable HTML email signatures per grant, and attach them automatically when sending messages or creating drafts.

CLI v3.1.1

Callback URI management, admin auth config fixes, and reduced code duplication across CLI commands.

Java SDK v2.15.1

Adds 'maybe' event status for calendar events and JSON body support for booking deletion.

Dashboard
DashboardDashboard

CLI authentication, disposable email blocking, and authentication reliability improvements.

Node.js SDK v8.0.5

Adds a scheduling availability API for retrieving availability via the new /v3/scheduling/availability endpoint.

Auth
AuthPlatform

Hosted auth improvements including plus-sign support in emails, IMAP/SMTP validation logging, and performance optimizations.

Ruby SDK v6.7.1

Fixes large attachment handling with string keys and custom content IDs.

Python SDK v6.14.2

Fixes UTF-8 encoding for special characters like emoji and accented letters in API requests.