Skip to content

Templates · Published 2026-09-28 · AgentiSend team

Scheduled send confirmation

Confirm to the person who scheduled an email when it will go out, and where to change or cancel it.

A handler for email.scheduled is the place this mail usually goes out.

Confirm to the person who scheduled an email when it will go out, and where to change or cancel it.

Variables

Every placeholder is required. A send that omits one is refused with that name, rather than going out with a blank.

  • scheduled_to (string, required). Who the scheduled email is addressed to.
  • scheduled_subject (string, required). The scheduled email’s subject line.
  • send_at (string, required). When it goes out, formatted for the reader with its time zone.
  • manage_url (string, required). An https link to where the person changes or cancels it.

Rendered with the example values

These values are samples. They are not an account on AgentiSend.

Subject: Scheduled: Quarterly numbers

<p>Your email is scheduled.</p>
<p>To: team@example.com<br>
Subject: Quarterly numbers<br>
Sends at: Friday 2 October 2026, 09:00 UTC</p>
<p>Until then you can change the time or cancel it.</p>
<p><a href="https://app.example.com/scheduled/em_7d2">Change or cancel it</a></p>
Your email is scheduled.

To: team@example.com
Subject: Quarterly numbers
Sends at: Friday 2 October 2026, 09:00 UTC

Until then you can change the time or cancel it.

Change or cancel it (https://app.example.com/scheduled/em_7d2)

Create the draft

POST /templates and the create_template tool take this body. The draft does not send until it is published.

{
  "name": "Scheduled send confirmation",
  "subject": "Scheduled: {{scheduled_subject}}",
  "content": {
    "mode": "markdown",
    "source": "Your email is scheduled.\n\nTo: {{scheduled_to}}\nSubject: {{scheduled_subject}}\nSends at: {{send_at}}\n\nUntil then you can change the time or cancel it.\n\n[Change or cancel it]({{manage_url}})"
  },
  "variables": [
    {
      "name": "scheduled_to",
      "type": "string",
      "required": true
    },
    {
      "name": "scheduled_subject",
      "type": "string",
      "required": true
    },
    {
      "name": "send_at",
      "type": "string",
      "required": true
    },
    {
      "name": "manage_url",
      "type": "string",
      "required": true
    }
  ]
}

Publish it

Call publish_template with the id POST /templates returned. Publishing again makes the next version. A version that already went out does not change.

{
  "name": "publish_template",
  "arguments": {
    "template_id": "<the id POST /templates returned>"
  }
}

Send it

Create the draft with the body above, publish it, then send with template_id and template_values. The rules are in Templates. The three calls, including a render that does not send, are in How do I send an email from a template. The next starter is Account paused.