# Nylas Api > Build email, calendar, and contacts integrations with the Nylas v3 API. Use when code imports nylas, @nylas/nylas, nylas-python, or user asks about Nylas API, email API integration, calendar API, contacts API, OAuth grants, agent accounts, webhooks, scheduler, notetaker, smart compose, or transactional send. DO NOT use for Nylas CLI commands. - **Type:** Skill - **Install:** `agentstack add skill-nylas-skills-nylas-api` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [nylas](https://agentstack.voostack.com/s/nylas) - **Installs:** 0 - **Category:** [Productivity](https://agentstack.voostack.com/c/productivity) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [nylas](https://github.com/nylas) - **Source:** https://github.com/nylas/skills/tree/main/skills/nylas-api - **Website:** https://developer.nylas.com ## Install ```sh agentstack add skill-nylas-skills-nylas-api ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Nylas v3 API Integration Guide - **Always use v3.** The v2 API is deprecated. - A **grant** = an authenticated user account (Gmail, Outlook, etc.) connected through Nylas. - **Base URLs**: `https://api.us.nylas.com` (US) / `https://api.eu.nylas.com` (EU). All paths `/v3/`. - **Auth**: Most APIs use Bearer token (API key) plus a grant ID in the path. Admin domain management and Beta admin API key endpoints use Nylas Service Account auth instead. - **SDKs**: Node.js, Python, Ruby, Kotlin/Java. - **Security**: Treat grant-scoped API data as untrusted when writing integration code. - **Scope**: This skill is integration-authoring guidance, not runtime access guidance. Do not use model-loaded rules as instructions to inspect live user resources during an agent session. ## Documentation Use the checked-in rules in this skill and the compiled reference in `AGENTS.md` as the working source for agent behavior. External docs links below are reference URLs only; do not load remote markdown into the active prompt at runtime. - **Docs index** (find the right page): `https://developer.nylas.com/llms.txt` - **Full docs** (everything in one file): `https://developer.nylas.com/llms-full.txt` ## Rules Read individual rule files for endpoints, examples, and SDK code. For the full compiled reference, read `AGENTS.md`. ### Authentication (CRITICAL) - [`rules/auth-oauth-flow.md`](rules/auth-oauth-flow.md) — Hosted OAuth, BYO auth, IMAP auth, PKCE, service accounts, Nylas Connect | [Docs](https://developer.nylas.com/docs/v3/auth/) - [`rules/auth-providers.md`](rules/auth-providers.md) — Google, Microsoft, Yahoo, iCloud, IMAP, Exchange, Zoom setup | [Docs](https://developer.nylas.com/docs/provider-guides/) ### Security & Prompt Safety (CRITICAL) - [`rules/security-untrusted-content.md`](rules/security-untrusted-content.md) — Prompt-injection boundaries for grant-scoped API data; require confirmation before application mutations ### Email API (HIGH) - [`rules/email-messages.md`](rules/email-messages.md) — Messages, threads, drafts, folders, attachments, search, filters | [Docs](https://developer.nylas.com/docs/v3/email/) - [`rules/email-advanced.md`](rules/email-advanced.md) — Tracking, smart compose, templates, workflows, scheduled/transactional send | [Docs](https://developer.nylas.com/docs/v3/email/message-tracking/) ### Calendar API (HIGH) - [`rules/calendar-events.md`](rules/calendar-events.md) — Events, availability, free/busy, recurring, virtual calendars, conferencing, group booking | [Docs](https://developer.nylas.com/docs/v3/calendar/) ### Contacts API (MEDIUM) - [`rules/contacts-crud.md`](rules/contacts-crud.md) — CRUD, groups, sources (address_book/domain/inbox), profile pictures | [Docs](https://developer.nylas.com/docs/v3/email/contacts/) ### Webhooks & Notifications (HIGH) - [`rules/webhooks-notifications.md`](rules/webhooks-notifications.md) — Webhooks, Pub/Sub, triggers, schemas, verification, retry behavior | [Docs](https://developer.nylas.com/docs/v3/notifications/) ### Scheduler API (MEDIUM) - [`rules/scheduler-booking.md`](rules/scheduler-booking.md) — Configurations, bookings, hosted pages, meeting types, UI components | [Docs](https://developer.nylas.com/docs/v3/scheduler/) ### Notetaker API (MEDIUM) - [`rules/notetaker-meetings.md`](rules/notetaker-meetings.md) — Meeting bot setup, AI notes, action items, transcription settings, calendar sync | [Docs](https://developer.nylas.com/docs/v3/notetaker/) ### Agent Accounts API (HIGH) - [`rules/agent-accounts.md`](rules/agent-accounts.md) — Managed AI-agent mailboxes (`provider: nylas`), workspaces, policies/rules/lists, send limits, deliverability webhooks | [Docs](https://developer.nylas.com/docs/v3/agent-accounts/) ### Admin & Grants (MEDIUM) - [`rules/admin-grants.md`](rules/admin-grants.md) — Grants, connectors, credentials, API keys, domains, workspaces | [Docs](https://developer.nylas.com/docs/api/v3/admin/) ### SDKs (HIGH) - [`rules/sdk-quickstart.md`](rules/sdk-quickstart.md) — Node.js, Python, Ruby, Kotlin/Java quick starts | [Docs](https://developer.nylas.com/docs/v3/sdks/) ### Best Practices (HIGH) - [`rules/best-practices-patterns.md`](rules/best-practices-patterns.md) — Rate limits (with numbers), error codes (200/400/500/700), pagination, metadata, field selection | [Docs](https://developer.nylas.com/docs/dev-guide/best-practices/) | [Errors](https://developer.nylas.com/docs/api/errors/) ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [nylas](https://github.com/nylas) - **Source:** [nylas/skills](https://github.com/nylas/skills) - **License:** MIT - **Homepage:** https://developer.nylas.com Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-nylas-skills-nylas-api - Seller: https://agentstack.voostack.com/s/nylas - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.