---
title: "Sets a reminder for a user in Slack."
method: POST
path: "/setUserReminder"
tags: ["user", "reminder"]
---

# Sets a reminder for a user in Slack.

`POST /setUserReminder`

Creates a new reminder for a specified user in Slack. It allows setting the reminder text and the time when the reminder should be triggered.

## Request body

- object
  - `body` object — Body of the setReminder sls call
    - `arguments` object, required
      - `userId` string, required — The ID of the user to set a reminder for. User IDs start with 'U'.
      - `text` string, required — The text of the reminder.
      - `time` string, required — A string describing when the reminder should fire (e.g., "in 5 minutes", "at 10pm", or a Unix timestamp).

## Response `200`

Successful response

- object
  - `ok` boolean, required — true if the request was successful.
  - `reminder` object, required — An object containing details of the new reminder.
    - `id` string — The ID of the created reminder.

## Other responses

- `400` — Bad Request - The request was invalid or cannot be served.
- `500` — Internal Server Error - The server has encountered a situation it doesn't know how to handle.

## Changes

- **2025-07-25** `dfc356a225b9` — 1 info
  - endpoint added
- **2025-06-20** `37c50ff8be3a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/microfox-ai/apis/slack-d/changes/setUserReminder/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.dev/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/revisions/cd0edf0c2cdf/schema)