Skip to content
Skip to main content
/
Documentation
Docs
API Reference
API
Notification Reference
Notifications
UI Reference
UI
Cookbook
Cookbook
Explore
Documentation
Documentation
Guides and tutorials
API Reference
REST API endpoints
Notification Reference
Webhook event schemas
UI Reference
Web components
Cookbook
Recipes and end-to-end use cases
Home
Getting started
What is Nylas
Get started: CLI
Get started: Dashboard
Build with Nylas
Guide for AI coding agents
Quickstart: Email API
Quickstart: Calendar & Events APIs
Quickstart: Notetaker API
Quickstart: Scheduler API
Quickstart: Contacts API
Quickstart: Transactional Send (Beta)
Quickstart: Agent Accounts
Nylas for AI Agents
Quickstart: AI agents
Share your email with your agent
Share your calendar with your agent
Give your agent its own email
Give your agent its own calendar
Give your agent call recordings
Give your agent contacts
Nylas MCP server
Security for AI agents
Authentication
Authenticating with Nylas
Setup guides
Hosted OAuth with API key
Hosted OAuth with access token & PKCE
Bring your own authentication
IMAP authentication
Service account
Nylas Connect
Overview
Nylas Connect JS
Nylas Connect overview
External IDPs
Overview
Auth0
Clerk
Google
WorkOS
Custom IDP
NylasConnect class
NylasConnect class overview
Authentication methods
connect()
getAuthUrl()
onConnectStateChange()
Callback methods
callback()
handleRedirectCallback()
Grant management methods
getConnectionStatus()
getSession()
logout()
Utility methods
setLogLevel()
Nylas Connect React
Nylas Connect React overview
useNylasConnect
External IDPs (React)
Overview
Auth0
Clerk
Google
WorkOS
NylasConnectButton component
Advanced
Bulk authentication grants
Using multiple provider applications
Customize the login prompt
Troubleshooting
Troubleshoot auth errors
Email
Email API
Using the Messages API
Sending messages
Using email signatures
Managing domains
Using templates & workflows
Idempotent send requests
Scheduling messages
Sending errors
Parsing messages
Using Smart Compose
Tracking messages
Using the Threads API
Using the Folders API
Using the Attachments API
Send large attachments
Using email headers & MIME data
Using the Contacts API
Calendar
Using the Calendar API
Using virtual calendars
Using the Events API
Checking availability
Checking free/busy information
Group availability & booking
Adding conferencing to events
Recurring events and RRULE
Scheduler
Using Scheduler
Using the Scheduler Editor component
Using the Scheduling component
Hosted Scheduling Pages
Customizing Scheduler
Localizing Scheduler
Scheduler & Notetaker Integration
Meeting types
Managing availability
Adding conferencing to bookings
Customizing booking flows
Retrieving booking IDs
Notetaker
Using Notetaker
Using calendar sync with Notetaker
Handling Notetaker media files
Scheduler & Notetaker Integration
Agent Accounts
Build
Using Agent Accounts
Setup domains
Provisioning Agent Accounts
Email, Calendars & Contacts
Mailboxes
Email threading
Calendars
Contacts
Governance
Workspaces
Policies, Rules, and Lists
Other
Mail client access (IMAP & SMTP)
Deliverability
Domain warming
Supported endpoints
Usage Limits
Notifications
Using webhooks
Using a Pub/Sub channel
Using an SNS channel
Receive with CLI
SDKs
Nylas SDKs
Node.js
Python
Ruby
Kotlin/Java
Provider guides
Integrating providers
Google
Using Google accounts & data
Creating a Google auth app
Shared GCP App
Verification & security assessment
Working with delegated mailboxes & Groups
Setting up service accounts
Setting up Pub/Sub
Microsoft
Using Microsoft accounts & data
Creating an Azure auth app
Authenticating Microsoft accounts
Configuring admin approval
Publisher verification guide
Suggested Microsoft 365 settings
Shared Outlook folders
Troubleshooting Microsoft configuration
IMAP & other providers
Using IMAP accounts & data
Troubleshooting IMAP configuration
Authenticating iCloud accounts
Authenticating Yahoo accounts
Using app passwords
Authenticating Exchange on-prem accounts
Zoom Meetings
Authenticating Zoom Meetings accounts
Troubleshooting Zoom Meetings
Developer resources
Get started
About Nylas
Developing with Nylas
Using the Dashboard
Nylas glossary
The Nylas platform
The Nylas platform
What is nyl.as?
API & provider rate limits
Data residency
Privacy mode
Field selection
Reporting abuse
Nylas static IP addresses
Nylas domain certificates
Supported attachment media types
Build & integrate
Nylas MCP server
AI prompts for building with Nylas
Using metadata
Using granular scopes
Customize Hosted Authentication branding
Best practices
Security best practices
Managing grants
Handling expired grants
Improving email deliverability
Best practices for webhooks
Reducing payload size
Searching
Avoiding rate limits
Error monitoring & handling
Dealing with spam
Support & troubleshooting
How to get support
Usage calculation & billing
GDPR overview & inquiries
Product lifecycle
Get header content
Changed email account password
Message not received
Nylas link directs to spam
Immediate webhook notifications
Missing notifications for read messages
Professional Services
Changelogs
Home
…
Code with the Nylas SDKs
Using the Node.js SDK
Test webhooks locally with the Node.js SDK
Test webhooks locally with the Node.js SDK
Actions
Last updated:
April 28, 2025
🚀
More information coming soon!