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://artifacts.apis.io/nylas/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"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. Requests support standard HTTP methods like `GET`, `PUT`, `POST`, and `DELETE`, and standard status codes. Response bodies are always UTF-8 encoded JSON objects, unless explicitly documented otherwise. You can use the Nylas Postman collection to quickly start using the Nylas APIs. For more information, check out the Nylas Postman collection documentation.
  contact:
    url: https://www.nylas.com/
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 (83 KB total) ---
# Full source: https://artifacts.apis.io/nylas/openapi/nylas-drafts-api-openapi.yml