An AI agent that can email but can't hold a calendar slot is only half useful. The moment a conversation turns into "let's meet Thursday at 2," the agent needs a real calendar — one that sends invitations people accept in Google Calendar or Outlook, receives invites at its own address, and RSVPs back so the organizer sees a real response next to everyone else's. Bolting a scheduling library onto a shared mailbox doesn't get you there; the agent needs a calendar identity of its own.
An Agent Account ships with exactly that. Every account gets a primary calendar that hosts events, accepts invitations over standard iCalendar, and RSVPs with yes, no, or maybe. To a participant, the agent is just another attendee on the invite. This post walks through using that calendar from two angles: the HTTP API for your backend, and the and , the Nylas product built for round-trip booking: its endpoints (/v3/scheduling/*) aren't available for Agent Account grants yet, per the — 200 messages a day on the free plan. Over quota, the event still saves but the invitation is skipped silently, so no one is notified.
Cancel with notification. Deleting an event without
notify_participants=true leaves it on participants' calendars. Use notification unless you mean to remove it quietly.Be explicit about time. Pass epoch
start_time/end_time or a timezone — the agent has no default zone, so an ambiguous time lands wherever the server guesses.send-rsvp is the only RSVP that counts. A reply email to the organizer won't move their calendar. Use the endpoint so the response propagates to every participant.
Wrapping up
A calendar turns an agent from something that talks about meetings into something that books them. The agent hosts events that real people accept, takes invitations at its own address, and RSVPs in a way every calendar respects — all through the same Events API you'd use for a connected account, plus the CLI for testing it by hand. The two habits that keep it clean: drive logic off the event webhooks, and set notify_participants on purpose every time.
Where to go next:
— request and response schemas for create, update, delete, and send-rsvp
— the Nylas hosted scheduling tool, not yet available for Agent Account grants
SOCIAL SHARE CARD GENERATOR