---
title: "Set a follow-up reminder"
method: POST
path: "/api/emails/{address}/messages/{id}/remind"
tags: ["Email"]
---

# Set a follow-up reminder

`POST /api/emails/{address}/messages/{id}/remind`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/messages/{id}/remind`
- Auth: HTTP bearer

Set (or clear with clear=true) a one-shot follow-up reminder on a message. When remind_at arrives and the message is still unanswered (inbound: no reply sent; outbound: no inbound reply received), email.reminder_due fires as a webhook + in-app notification and the reminder clears itself.

## Path parameters

- `address` string, required
- `id` string, required

## Request body

- object
  - `remind_at` string, date-time: ISO 8601 time to be reminded (1 minute to 90 days out)
  - `note` string: Context shown when the reminder fires
  - `clear` boolean: Clear a pending reminder

## Response `200`

Reminder state updated

- object
  - `id` string
  - `remind_at` string, nullable
  - `reminder_note` string, nullable

## Other responses

- `404`: Mailbox or message not found

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)