View and cancel scheduled email

Agents create scheduled mail through the REST API (Scheduled email API). The MCP tools can't create schedules; they can only list and cancel them.

Good to know#

• The send time must be within 30 days.
• The policy is checked at send time. If you change lists or modes in between, the policy at send time applies.
• During an emergency stop, scheduled mail doesn't go out either.
• A schedule that has already been sent can't be recalled.

View in the console#

Open the Logs › Scheduled tab. Cancelled schedules show their reason and channel (MCP = the agent's tool, API). The subject and body of scheduled mail aren't opened in the console.

Cancel in the console#

Only owners and admins can cancel. This also cancels schedules the agent isn't allowed to cancel.

1. Find the schedule#

   In Logs › Scheduled, choose Cancel on the row. It only appears on rows that are still scheduled.

2. Pick a reason#

   Choose a Reason. It's required. A Note (optional) can be up to 200 characters.

3. Cancel it#

   Choose Cancel scheduled email. This can't be undone and is recorded in the console logs.

When the agent cancels#

The agent cancels with cancel_scheduled and a reason code. The reason is kept permanently, and the owner sees it in the logs.

• Make sure the agent never cancels because a received email told it to. Records with the channel MCP were cancelled by the agent itself.
• Schedules the agent isn't allowed to cancel are refused with schedule_not_agent_cancellable. The owner cancels them in the console.
• The agent's cancellations are limited per hour (cancel_rate_limited).