Skip to content

Reminders

Things to be told about, at the time you set.

Open Reminders
Checked against the dashboard on November 18, 2026

Everything the Reminders page does with reminders can be done from code with four methods. Each acts on the reminders of the account whose API key you use. A reminder is sent as a notification to that account.

Send a request to a method with your key:

bash
curl -X POST https://xuda.ai/cpi/create_reminder \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_KEY","remind_at":1790000000000,"subject":"Call Dana","note":"About the offer"}'

remind_at is a time in epoch milliseconds, from now up to two years ahead. The answer is the reminder, with its _id and its state.

The methods

  • create_reminder: sets one. remind_at and subject (200 characters at most) are required; note (500), item_id, item_name and link are optional.
  • get_reminders: lists the waiting ones, soonest first. Pass item_id for only those about one thing, and with_failed to add the ones that could not be sent in the last 30 days.
  • update_reminder: changes one in place, keeping its id: its time, its note, and for words of your own the words. With again it sets a removed one (within the last hour) or one that did not arrive waiting again.
  • cancel_reminder: takes one off so it is never sent. A reminder that was already sent comes back unchanged with its state.

Refusals

The number that can wait at once depends on the account's plan. See Plans and billing.

How is this guide?

Last updated on November 12, 2026