Sample - Slack Web API
POST/reminders.add

Create a reminder

Creates a reminder for the authenticated user or for the user specified by user. Supply the reminder text and its time, which can be a Unix timestamp, a delay in seconds, or a natural-language schedule. The response returns the created reminder and its scheduling details.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 3 body fields
tokenstringrequired
Authentication token with the `reminders:write` scope.

Form-encoded reminder details containing the reminder text, schedule, and optional recipient.

textstringrequired
The content of the reminder
timestringrequired
When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday")
userstringoptional
The user who will receive the reminder. If no user is specified, the reminder will go to user who created it.

2 status codes
200Returns the created reminder, including its identifier, creator, recipient, text, schedule, and recurring status.
okbooleanrequired
Allowed:true
reminderobjectrequired
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:cannot_parseuser_not_foundcannot_add_botcannot_add_slackbotcannot_add_otherscannot_add_others_recurringnot_authedinvalid_authaccount_inactivetoken_revokedno_permissionorg_login_required
okbooleanrequired
Allowed:false

Error handling

The token must grant the reminders:write scope. Supply both text and time; time must be a Unix timestamp within five years, a delay in seconds within 24 hours, or a supported natural-language schedule.