Nylas

Nylas Drafts API

Drafts. Compose, update, send and delete drafts, manage attachments, and generate draft bodies and replies with Smart Compose.

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/grants/{grant_id}/drafts List a user's email drafts · Return all Drafts #
Ask an LLM
“How do I see all the drafts sitting in a user's Drafts folder?”
“Can I filter drafts by recipient or subject?”
Tell an agent
List the drafts in mailbox {grant_id}.
Find drafts in {grant_id} addressed to {to}.
POST /v3/grants/{grant_id}/drafts Save a new email draft · Create a Draft #
Ask an LLM
“Can I save an email as a draft without sending it?”
“Is it possible to create a draft reply to an existing message?”
Tell an agent
Create a draft in {grant_id} to {to} with subject {subject}.
Save a draft reply to message {reply_to_message_id} in mailbox {grant_id}.
GET /v3/grants/{grant_id}/drafts/{draft_id} Retrieve a single email draft · Return a Draft #
Ask an LLM
“How can I open one specific draft to check its contents?”
“Can I look up a draft by its ID?”
Tell an agent
Get draft {draft_id} from mailbox {grant_id}.
Show me the contents of draft {draft_id} for grant {grant_id}.
PUT /v3/grants/{grant_id}/drafts/{draft_id} Edit an existing email draft · Update a draft #
Ask an LLM
“Can I change the recipients or body of a draft I already saved?”
“What happens to nested fields when I update a draft?”
Tell an agent
Change the subject of draft {draft_id} in {grant_id} to {subject}.
Rewrite the body of draft {draft_id} for grant {grant_id} as {body}.
DELETE /v3/grants/{grant_id}/drafts/{draft_id} Delete an email draft · Delete a Draft #
Ask an LLM
“How do I throw away a draft I don't need?”
“Is deleting a draft permanent?”
Tell an agent destructive · confirm first
Delete draft {draft_id} from mailbox {grant_id}.
Discard unsent draft {draft_id} for grant {grant_id}.
POST /v3/grants/{grant_id}/drafts/{draft_id} Send a saved draft · Send a Draft #
Ask an LLM
“How do I send an email that's currently saved as a draft?”
“Can I attach a signature to a draft at the moment I send it?”
Tell an agent
Send draft {draft_id} from mailbox {grant_id}.
Send saved draft {draft_id} for {grant_id} with signature {signature_id}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-drafts-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nylas:nylas-drafts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nylas-drafts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nylas Drafts API
  version: v3
  summary: The complete Nylas v3 API — Email, Calendar, Contacts, Notetaker, Scheduling, Administration, and Migration.
  description: The Nylas API is designed using the REST ideology to provide simple and predictable URIs to access and modify objects.
  contact:
    url: https://www.nylas.com/
  x-provenance:
    method: harvested
    first_party: true
    publisher: Nylas
    source: https://developer.nylas.com/_spec-files/nylas-api.yaml
    harvested: '2026-08-21'
    sha256: 7ff001d571e163b1ffe22178741b59f813d8208ec878157a839a33dc2c13fd35
    bytes: 1666223
    note: 'Published by Nylas as the unified contract for the Nylas v3 API and stored verbatim; API Evangelist added only this provenance block. Submitted by the provider in api-evangelist/nylas#1 and verified against the live URL before harvest: 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. This document REPLACES a 22-operation scaffold API Evangelist derived from reading the documentation, now quarantined under openapi/_scaffold/.'
  x-evidence:
  - url: https://developer.nylas.com/_spec-files/nylas-api.yaml
    what: the published unified contract, harvested verbatim 2026-08-21 (200, text/yaml, 1,666,223 bytes)
  - url: https://developer.nylas.com/.well-known/api-catalog
    what: RFC 9727 linkset advertising that URL as service-desc for api.us.nylas.com and api.eu.nylas.com (200, application/linkset+json)
servers:
- url: https://api.us.nylas.com
  description: U.S.
- url: https://api.eu.nylas.com
  description: E.U.
security:
- ACCESS_TOKEN: []
- NYLAS_API_KEY: []
tags:


# --- truncated at 32 KB (77 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-drafts-api-openapi.yml