Nylas API · 邮件日历与联系人集成

Nylas官方v3 REST API通过已授权grant访问邮件、日历、联系人等，可查询，也可发送、更新或删除数据。支持分页和字段选择，通常返回UTF-8 JSON。仅文档整理、未接账户；费用、具体权限、留存与运行结果未验证。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-7fd6c45a193c1eabf3d5c62e
Card version: 2
Updated: 2026-10-24T17:49:02.2830017+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

Complete API reference for the Nylas v3 APIs. Browse endpoints for email, calendar, contacts, scheduling, authentication, and administration.

Inputs

路径/v3/grants/{grant_id}/messages、events、contacts等；grant标识可真实ID、email、external形式，me受access token限制。
列表limit默认50最高200，page_token取前次next_cursor；按资源可加时间、邮件字段、calendar_id等过滤。
select可选顶层字段，metadata_pair有单独组合限制；写入内容和必填字段随端点。

Outputs

通常UTF-8 JSON对象，含资源data及可能的next_cursor；单独文档明确的特殊响应除外。
可返回邮件/线程、日历事件、联系人等数据；部分端点会发送邮件、修改或删除真实资源，不只是输出查询。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u666E\u901Agrant\u8DEF\u5F84\u53EFAPI key\u6216access token\u6388\u6743\uFF0C/v3/grants/me\u4EC5\u652F\u6301access token\u3002\u8FD8\u9700\u5DF2\u8FDE\u63A5grant\u53CA\u5BF9\u5E94scope\uFF1BOAuth/BYO\u8BA4\u8BC1\u7EC6\u8282\u9700\u76F8\u5E94\u53C2\u8003\u3002\u672C\u8F6E\u672A\u83B7\u53D6key\u3001\u767B\u5F55\u6216\u6388\u6743\u90AE\u7BB1\u3002"
  },
  "command": null,
  "entry_url": "https://api.us.nylas.com",
  "kind": "http_api",
  "method": null,
  "request_example": null,
  "requirements": [
    "Nylas\u5E94\u7528\u3001\u6709\u6548\u8BA4\u8BC1\u548C\u5177\u6709\u76F8\u5E94scope\u7684grant\uFF1B\u5DF2\u6709ID\u672C\u8EAB\u4E0D\u6388\u4E88\u8BBF\u95EE\u6743\u3002",
    "\u5F53\u524D\u9875\u660E\u786E\u7F8E\u56FDbase URL\uFF1B\u5176\u4ED6region\u548C\u5E94\u7528\u5F52\u5C5E\u987B\u6838\uFF0C\u4E0D\u81EA\u884C\u63A8\u5BFCEU\u5730\u5740\u6216\u8DE8\u533A\u6743\u9650\u3002",
    "\u6309\u5177\u4F53\u8D44\u6E90\u4F7F\u7528GET/POST/PUT/PATCH/DELETE\u53CA\u5176schema\uFF0C\u5199\u64CD\u4F5C\u9700\u5355\u72EC\u786E\u8BA4\u610F\u56FE\u4E0E\u6743\u9650\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u5F53\u524DAPI\u53C2\u8003\u672A\u5217\u5957\u9910\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u6309\u7528\u6237\u6216\u6309\u91CF\u8D39\u7528\uFF1B\u4E0D\u63A8\u65AD\u6240\u6709\u5217\u51FA\u7684\u4EA7\u54C1/\u7BA1\u7406\u529F\u80FD\u5747\u5728\u540C\u4E00\u5957\u9910\u53EF\u7528\u3002",
  "source_url": "https://developer.nylas.com/docs/reference/api/"
}

{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8FDE\u63A5\u53EF\u5904\u7406\u7528\u6237\u90AE\u7BB1\u3001\u8054\u7CFB\u4EBA\u3001\u65E5\u5386\u53CA\u5F55\u97F3/\u8F6C\u5F55\u7B49\u654F\u611F\u8D44\u6599\uFF0C\u5E76\u53EF\u80FD\u5411\u90AE\u4EF6\u63D0\u4F9B\u65B9\u6216\u6536\u4EF6\u4EBA\u5199\u5165/\u53D1\u9001\u3002scope\u3001\u6570\u636E\u5730\u57DF\u3001\u7559\u5B58\u3001\u7B2C\u4E09\u65B9\u5904\u7406\u548C\u9690\u79C1\u5408\u540C\u672A\u6838\u3002\u672C\u8F6E\u672A\u8FDE\u63A5\u8D26\u6237\u6216\u8BFB\u53D6\u7528\u6237\u6570\u636E\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

不是只读接口；发送邮件、预约、录音Notetaker和管理端点等具有外部影响，不能把页面可见性当调用授权。
me不能用API key，需关联用户的access token；不同grant和应用scope不能互相替代。
PUT/PATCH可替换嵌套对象内容，遗漏其必填字段可能失败；metadata空对象可清除值，不当无副作用更新。
select仅顶层，DELETE、附件、Smart Compose、Send Message和Create Draft等有例外；provider/Nylas限流仍需另核。

Unknowns

OAuth/BYO具体流程、key传递格式和真实scope未在本轮核验。
价格、限流、存储/保留、地区合规与服务保证未知。
未发送邮件、创建事件、录音或实际调用任何API。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:46:20.0173155\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developer.nylas.com/docs/reference/api/"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u8FDE\u63A5\u53EF\u5904\u7406\u7528\u6237\u90AE\u7BB1\u3001\u8054\u7CFB\u4EBA\u3001\u65E5\u5386\u53CA\u5F55\u97F3/\u8F6C\u5F55\u7B49\u654F\u611F\u8D44\u6599\uFF0C\u5E76\u53EF\u80FD\u5411\u90AE\u4EF6\u63D0\u4F9B\u65B9\u6216\u6536\u4EF6\u4EBA\u5199\u5165/\u53D1\u9001\u3002scope\u3001\u6570\u636E\u5730\u57DF\u3001\u7559\u5B58\u3001\u7B2C\u4E09\u65B9\u5904\u7406\u548C\u9690\u79C1\u5408\u540C\u672A\u6838\u3002\u672C\u8F6E\u672A\u8FDE\u63A5\u8D26\u6237\u6216\u8BFB\u53D6\u7528\u6237\u6570\u636E\u3002"
  },
  "description": "Complete API reference for the Nylas v3 APIs. Browse endpoints for email, calendar, contacts, scheduling, authentication, and administration.",
  "inputs": [
    "\u8DEF\u5F84/v3/grants/{grant_id}/messages\u3001events\u3001contacts\u7B49\uFF1Bgrant\u6807\u8BC6\u53EF\u771F\u5B9EID\u3001email\u3001external\u5F62\u5F0F\uFF0Cme\u53D7access token\u9650\u5236\u3002",
    "\u5217\u8868limit\u9ED8\u8BA450\u6700\u9AD8200\uFF0Cpage_token\u53D6\u524D\u6B21next_cursor\uFF1B\u6309\u8D44\u6E90\u53EF\u52A0\u65F6\u95F4\u3001\u90AE\u4EF6\u5B57\u6BB5\u3001calendar_id\u7B49\u8FC7\u6EE4\u3002",
    "select\u53EF\u9009\u9876\u5C42\u5B57\u6BB5\uFF0Cmetadata_pair\u6709\u5355\u72EC\u7EC4\u5408\u9650\u5236\uFF1B\u5199\u5165\u5185\u5BB9\u548C\u5FC5\u586B\u5B57\u6BB5\u968F\u7AEF\u70B9\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u666E\u901Agrant\u8DEF\u5F84\u53EFAPI key\u6216access token\u6388\u6743\uFF0C/v3/grants/me\u4EC5\u652F\u6301access token\u3002\u8FD8\u9700\u5DF2\u8FDE\u63A5grant\u53CA\u5BF9\u5E94scope\uFF1BOAuth/BYO\u8BA4\u8BC1\u7EC6\u8282\u9700\u76F8\u5E94\u53C2\u8003\u3002\u672C\u8F6E\u672A\u83B7\u53D6key\u3001\u767B\u5F55\u6216\u6388\u6743\u90AE\u7BB1\u3002"
    },
    "command": null,
    "entry_url": "https://api.us.nylas.com",
    "kind": "http_api",
    "method": null,
    "request_example": null,
    "requirements": [
      "Nylas\u5E94\u7528\u3001\u6709\u6548\u8BA4\u8BC1\u548C\u5177\u6709\u76F8\u5E94scope\u7684grant\uFF1B\u5DF2\u6709ID\u672C\u8EAB\u4E0D\u6388\u4E88\u8BBF\u95EE\u6743\u3002",
      "\u5F53\u524D\u9875\u660E\u786E\u7F8E\u56FDbase URL\uFF1B\u5176\u4ED6region\u548C\u5E94\u7528\u5F52\u5C5E\u987B\u6838\uFF0C\u4E0D\u81EA\u884C\u63A8\u5BFCEU\u5730\u5740\u6216\u8DE8\u533A\u6743\u9650\u3002",
      "\u6309\u5177\u4F53\u8D44\u6E90\u4F7F\u7528GET/POST/PUT/PATCH/DELETE\u53CA\u5176schema\uFF0C\u5199\u64CD\u4F5C\u9700\u5355\u72EC\u786E\u8BA4\u610F\u56FE\u4E0E\u6743\u9650\u3002"
    ]
  },
  "limitations": [
    "\u4E0D\u662F\u53EA\u8BFB\u63A5\u53E3\uFF1B\u53D1\u9001\u90AE\u4EF6\u3001\u9884\u7EA6\u3001\u5F55\u97F3Notetaker\u548C\u7BA1\u7406\u7AEF\u70B9\u7B49\u5177\u6709\u5916\u90E8\u5F71\u54CD\uFF0C\u4E0D\u80FD\u628A\u9875\u9762\u53EF\u89C1\u6027\u5F53\u8C03\u7528\u6388\u6743\u3002",
    "me\u4E0D\u80FD\u7528API key\uFF0C\u9700\u5173\u8054\u7528\u6237\u7684access token\uFF1B\u4E0D\u540Cgrant\u548C\u5E94\u7528scope\u4E0D\u80FD\u4E92\u76F8\u66FF\u4EE3\u3002",
    "PUT/PATCH\u53EF\u66FF\u6362\u5D4C\u5957\u5BF9\u8C61\u5185\u5BB9\uFF0C\u9057\u6F0F\u5176\u5FC5\u586B\u5B57\u6BB5\u53EF\u80FD\u5931\u8D25\uFF1Bmetadata\u7A7A\u5BF9\u8C61\u53EF\u6E05\u9664\u503C\uFF0C\u4E0D\u5F53\u65E0\u526F\u4F5C\u7528\u66F4\u65B0\u3002",
    "select\u4EC5\u9876\u5C42\uFF0CDELETE\u3001\u9644\u4EF6\u3001Smart Compose\u3001Send Message\u548CCreate Draft\u7B49\u6709\u4F8B\u5916\uFF1Bprovider/Nylas\u9650\u6D41\u4ECD\u9700\u53E6\u6838\u3002"
  ],
  "outputs": [
    "\u901A\u5E38UTF-8 JSON\u5BF9\u8C61\uFF0C\u542B\u8D44\u6E90data\u53CA\u53EF\u80FD\u7684next_cursor\uFF1B\u5355\u72EC\u6587\u6863\u660E\u786E\u7684\u7279\u6B8A\u54CD\u5E94\u9664\u5916\u3002",
    "\u53EF\u8FD4\u56DE\u90AE\u4EF6/\u7EBF\u7A0B\u3001\u65E5\u5386\u4E8B\u4EF6\u3001\u8054\u7CFB\u4EBA\u7B49\u6570\u636E\uFF1B\u90E8\u5206\u7AEF\u70B9\u4F1A\u53D1\u9001\u90AE\u4EF6\u3001\u4FEE\u6539\u6216\u5220\u9664\u771F\u5B9E\u8D44\u6E90\uFF0C\u4E0D\u53EA\u662F\u8F93\u51FA\u67E5\u8BE2\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u5F53\u524DAPI\u53C2\u8003\u672A\u5217\u5957\u9910\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u6309\u7528\u6237\u6216\u6309\u91CF\u8D39\u7528\uFF1B\u4E0D\u63A8\u65AD\u6240\u6709\u5217\u51FA\u7684\u4EA7\u54C1/\u7BA1\u7406\u529F\u80FD\u5747\u5728\u540C\u4E00\u5957\u9910\u53EF\u7528\u3002",
    "source_url": "https://developer.nylas.com/docs/reference/api/"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:46:20.0173155\u002B00:00",
      "title": "API Reference | Docs",
      "url": "https://developer.nylas.com/docs/reference/api/"
    }
  ],
  "summary": "Nylas\u5B98\u65B9v3 REST API\u901A\u8FC7\u5DF2\u6388\u6743grant\u8BBF\u95EE\u90AE\u4EF6\u3001\u65E5\u5386\u3001\u8054\u7CFB\u4EBA\u7B49\uFF0C\u53EF\u67E5\u8BE2\uFF0C\u4E5F\u53EF\u53D1\u9001\u3001\u66F4\u65B0\u6216\u5220\u9664\u6570\u636E\u3002\u652F\u6301\u5206\u9875\u548C\u5B57\u6BB5\u9009\u62E9\uFF0C\u901A\u5E38\u8FD4\u56DEUTF-8 JSON\u3002\u4EC5\u6587\u6863\u6574\u7406\u3001\u672A\u63A5\u8D26\u6237\uFF1B\u8D39\u7528\u3001\u5177\u4F53\u6743\u9650\u3001\u7559\u5B58\u4E0E\u8FD0\u884C\u7ED3\u679C\u672A\u9A8C\u8BC1\u3002",
  "tags": [
    "Nylas",
    "\u90AE\u4EF6API",
    "\u65E5\u5386API",
    "\u8054\u7CFB\u4EBA",
    "REST",
    "\u8D26\u6237\u6388\u6743",
    "\u53EF\u8BFB\u5199"
  ],
  "terms_url": null,
  "title": "Nylas API \u00B7 \u90AE\u4EF6\u65E5\u5386\u4E0E\u8054\u7CFB\u4EBA\u96C6\u6210",
  "unknowns": [
    "OAuth/BYO\u5177\u4F53\u6D41\u7A0B\u3001key\u4F20\u9012\u683C\u5F0F\u548C\u771F\u5B9Escope\u672A\u5728\u672C\u8F6E\u6838\u9A8C\u3002",
    "\u4EF7\u683C\u3001\u9650\u6D41\u3001\u5B58\u50A8/\u4FDD\u7559\u3001\u5730\u533A\u5408\u89C4\u4E0E\u670D\u52A1\u4FDD\u8BC1\u672A\u77E5\u3002",
    "\u672A\u53D1\u9001\u90AE\u4EF6\u3001\u521B\u5EFA\u4E8B\u4EF6\u3001\u5F55\u97F3\u6216\u5B9E\u9645\u8C03\u7528\u4EFB\u4F55API\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:46:20.0173155\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developer.nylas.com/docs/reference/api/"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-7fd6c45a193c1eabf3d5c62e",
  "version": 2,
  "source_url": "https://developer.nylas.com/docs/reference/api/",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://developer.nylas.com/docs/reference/api/",
    "final_url": "https://developer.nylas.com/docs/reference/api/",
    "status_code": 200,
    "title": "API Reference | Docs",
    "description": "Complete API reference for the Nylas v3 APIs. Browse endpoints for email, calendar, contacts, scheduling, authentication, and administration.",
    "checked_at": "2026-10-24T17:46:20.0173155\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:46:23.6319713\u002B00:00",
  "updated_at": "2026-10-24T17:49:02.2830017\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-7fd6c45a193c1eabf3d5c62e?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-7fd6c45a193c1eabf3d5c62e?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u4E1A\u52A1\u901A\u4FE1\uFF5C\u9700\u6388\u6743\u7684\u90AE\u4EF6\u65E5\u5386\u8054\u7CFB\u4EBAREST API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-9efefb21dba51552c33d4a03cbe91640",
        "source_url": "https://developer.nylas.com/docs/reference/api/",
        "content_sha256": "2b435b39362d104bf97bc715c18f37e5b481c692c40b9e1e9ad4903f48631654",
        "decoded_bytes": 465079,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:46:20.0173155\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "2b435b39362d104bf97bc715c18f37e5b481c692c40b9e1e9ad4903f48631654",
        "text_utf8_bytes": 465079,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-7fd6c45a193c1eabf3d5c62e/materials/material-9efefb21dba51552c33d4a03cbe91640?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-f15af24505cb41f58ce407567c6aa2b1",
    "reason": "\u636E\u672C\u6279Nylas\u5B98\u65B9API\u53C2\u8003\u6574\u7406v3\u57FA\u7840\u5730\u5740\u3001grants\u8BA4\u8BC1\u3001\u8BFB\u5199\u8303\u56F4\u4E0E\u5206\u9875\uFF1B\u4E0D\u8FDE\u63A5\u7528\u6237\u90AE\u7BB1\u6216\u66F4\u6539\u6570\u636E\u3002",
    "source_urls": [
      "https://developer.nylas.com/docs/reference/api/"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-7fd6c45a193c1eabf3d5c62e",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-7fd6c45a193c1eabf3d5c62e?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-7fd6c45a193c1eabf3d5c62e?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure