Nylas

Nylas Contacts API

Contacts. Read, create, update and delete a grant's contacts and contact groups.

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

POST /v3/grants/{grant_id}/contacts Add a contact to an address book · Create contact #
Ask an LLM
“How do I add a new person to a user's address book?”
“Can I save a job title and company when creating a contact?”
Tell an agent
Add a contact named {given_name} {surname} for grant {grant}.
Create contact {given_name} at {company_name} on {grant}.
GET /v3/grants/{grant_id}/contacts List or filter a user's contacts · Return all contacts #
Ask an LLM
“Which contacts in someone's address book have a given email address?”
“Can I list only the contacts in one contact group?”
Tell an agent
List contacts for grant {grant}.
Find contacts on {grant} with email {email}.
GET /v3/grants/{grant_id}/contacts/{contact_id} Get one contact · Return a contact #
Ask an LLM
“What details do we have for a specific contact?”
“Can I get a contact's profile picture as image data?”
Tell an agent
Show contact {contact} for grant {grant}.
Get contact {contact} on {grant} including the profile picture.
PUT /v3/grants/{grant_id}/contacts/{contact_id} Update a contact's details · Update a contact #
Ask an LLM
“Can I change an existing contact's job title or notes?”
“What happens to nested fields when I update a contact?”
Tell an agent
Update the job title of contact {contact} on {grant} to {job_title}.
Change contact {contact}'s given name to {given_name} for grant {grant}.
DELETE /v3/grants/{grant_id}/contacts/{contact_id} Delete a contact · Delete a contact #
Ask an LLM
“How do I remove someone from a user's address book?”
“Can I delete a single contact by ID?”
Tell an agent destructive · confirm first
Delete contact {contact} from grant {grant}.
Remove contact {contact} from the address book on {grant}.
GET /v3/grants/{grant_id}/contacts/groups List contact groups · Return all Contact Groups #
Ask an LLM
“What contact groups does this account have?”
“Are contact groups available for every email provider?”
Tell an agent
List contact groups for grant {grant}.
Show all contact groups on {grant}.

Specifications

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

Other Resources

🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/apis.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-contacts-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-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nylas Contacts 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 (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-contacts-api-openapi.yml