Skip to content
Skip to main content

Nylas Agent Accounts (Beta)

Agent AccountsEmailCalendar

Added

Section titled “Added”

  • Agent Accounts — A new grant type for agents that need their own identity instead of access to a human’s inbox. An Agent Account is a real [email protected] mailbox that sends and receives mail, hosts and responds to calendar events, and uses the same grant_id contract as any connected account — so every existing Messages, Drafts, Threads, Folders, Calendars, Events, and Webhooks endpoint works against it with no new concepts. See the Agent Accounts overview and the quickstart.

  • Provisioning through CLI, Dashboard, or API — Create an Agent Account with nylas agent create, through the Dashboard, or by calling POST /v3/connect/custom with the new Nylas (Agent Account) variant. The variant accepts email, policy_id, and an optional app_password so the same mailbox can be reached from an IMAP or SMTP client as well as the API. See Provisioning and domains.

  • Policies, Rules, and Lists — 13 new API operations for configuring agent behavior at the mailbox level. Policies define what an agent can do, Rules apply conditional logic to inbound and outbound messages, and Lists hold the values that rules reference (allow-lists, deny-lists, VIP senders, quarantine domains). All operations live under the Administration section and are marked beta:

    • Policies — POST, GET, GET /{id}, PUT /{id}, DELETE /{id} under /v3/policies
    • Rules — POST, GET, GET /{id}, PUT /{id}, DELETE /{id} under /v3/rules
    • Lists — POST, GET, GET /{id}, PUT /{id}, DELETE /{id} under /v3/lists, plus POST, GET, and DELETE for list items at /v3/lists/{id}/items

  • Rule evaluations audit trail — GET /v3/grants/{grant_id}/rule-evaluations returns a time-ordered record of every rule that fired on a grant, including the matched conditions and the action taken. Use it to debug why a message was blocked, routed, or modified.

  • Mail client access (IMAP and SMTP) — Set an app_password on an Agent Account to connect it from a standard mail client. The Mail clients page documents host and port configuration, folder mapping, and the bidirectional-sync behavior between Nylas and the connected client.

  • Supported endpoints reference — The Supported endpoints page lists every API endpoint and webhook trigger that works on an Agent Account grant, plus the small set that explicitly doesn’t (Scheduler, Notetaker, and a handful of provider-only features).

  • AI-agent onboarding split by identity model — The getting-started section now distinguishes between pointing an agent at a human’s inbox (Share your email / Share your calendar) and giving the agent its own identity (Give your agent its own email / Give your agent its own calendar). The CLI quickstart opens with a short Pick an identity model decision section so you land on the right path immediately.

  • Scheduling-agent tutorial — A full end-to-end use-case walkthrough under Scheduling agent with a dedicated identity covers webhook setup, LLM parsing of inbound requests, free/busy checks against the agent’s own calendar, event creation, and RSVP tracking.

  • Recipes — Two short how-tos under /docs/v3/guides/agent-accounts/: Sign an agent up for a third-party service and Extract an OTP or 2FA code from an agent’s inbox.