Reference · Mutation

`createReminder`

🔔 Create a reminder on a date, once or repeating

Arguments

Name	Type	Description
`tasks`	`[String!]!`	Unique identifiers of the `Tasks` to include in the reminder
`users`	`[String!]!`	Unique identifiers of the `Users` to assign the reminder to
`date`	`Date!`	Date of the reminder (ISO string, e.g. `"2026-03-15"`)
`time`	`Time`	Optional time of day in the team's timezone. If omitted, creates an all-day reminder
`repeat`	`RepeatInput`	How the reminder repeats from `date`. If omitted, creates a one-time reminder
`rotate`	`Boolean`	With `repeat` only: the users take turns, one at a time, instead of all being reminded Default: `false`

Returns

Reminder

Example

mutation {
  createReminder(
    tasks: ["TASK_UID"]
    users: ["USER_UID", "OTHER_USER_UID"]
    date: "2026-03-16"
    time: "19:00"
    repeat: { mode: STATIC, weekdays: [1, 4] }
    rotate: true
  ) {
    uid
    time
    repeat { mode weekdays everyWeeks }
  }
}