Guides | Docs

Looking for end-to-end tutorials that combine multiple Nylas APIs? See Use cases.

The Nylas API gives you one interface for every provider, but each provider behaves differently. Folder structures, sync timing, rate limits, search capabilities, and authentication flows all vary depending on whether you’re working with Microsoft, Google, Yahoo, iCloud, IMAP, or Exchange.

These guides walk you through each provider’s specifics so you can build with confidence. Every guide focuses on a single task for a single provider, with code samples and the details that actually matter in production.

Email

Messages

Guide	Provider	What you’ll do
List Microsoft messages	Microsoft 365, Outlook	Retrieve and filter email from Microsoft accounts, handle folder naming, pagination, and sync behavior
List Google messages	Gmail, Google Workspace	Retrieve and filter email from Google accounts, use Gmail search operators, handle labels, and manage OAuth scopes
List Yahoo messages	Yahoo Mail	Retrieve and filter email from Yahoo accounts, handle the 90-day message cache, use query_imap for older messages
List iCloud messages	iCloud Mail	Retrieve and filter email from iCloud accounts, handle app-specific passwords, the 90-day cache, and CalDAV vs. IMAP
List IMAP messages	Any IMAP server	Retrieve and filter email from any IMAP provider (Zoho, Fastmail, AOL, custom servers), handle folder naming and UIDVALIDITY
List Exchange messages	Exchange on-premises	Retrieve and filter email from self-hosted Exchange servers via EWS, handle message ID changes and AQS search

Threads

Guide	Provider	What you’ll do
List Microsoft threads	Microsoft 365, Outlook	Retrieve and filter email threads from Microsoft accounts, understand ConversationId mapping, thread-level metadata, and folder behavior
List Google threads	Gmail, Google Workspace	Retrieve and filter email threads from Google accounts, use native thread_id, handle labels on threads, and Gmail search operators
List Yahoo threads	Yahoo Mail	Retrieve and filter email threads from Yahoo accounts, understand header-based thread grouping and the 90-day cache
List iCloud threads	iCloud Mail	Retrieve and filter email threads from iCloud accounts, handle app-specific passwords and header-based threading
List IMAP threads	Any IMAP server	Retrieve and filter email threads from any IMAP provider, understand header-based grouping and UIDVALIDITY
List Exchange threads	Exchange on-premises	Retrieve and filter email threads from Exchange on-prem via EWS, handle ConversationId and message ID changes

Calendar

Events

Guide	Provider	What you’ll do
List Microsoft events	Microsoft 365, Outlook	Retrieve and filter calendar events from Microsoft accounts, handle timezone normalization, Teams conferencing, and admin consent
List Google events	Google Calendar, Workspace	Retrieve and filter calendar events from Google accounts, use event types, handle Google Meet conferencing, and manage OAuth scopes
List iCloud events	iCloud Calendar	Retrieve and filter calendar events from iCloud accounts, handle app-specific passwords, CalDAV limitations, and the one-year range cap
List Exchange events	Exchange on-premises	Retrieve and filter calendar events from self-hosted Exchange servers via EWS, handle on-prem networking and recurring event restrictions
Create Microsoft events	Microsoft 365, Outlook	Create calendar events on Microsoft accounts, handle write scopes, Teams conferencing, participant notifications, and room resources
Create Google events	Google Calendar, Workspace	Create calendar events on Google accounts, handle restricted scopes, Google Meet auto-create, and event type limitations
Create iCloud events	iCloud Calendar	Create calendar events on iCloud accounts, handle app-specific passwords, CalDAV limitations, and the simpler event model
Create Exchange events	Exchange on-premises	Create calendar events on Exchange on-prem via EWS, handle write scopes, recurring event restrictions, and on-prem networking