Scheduler API for Premium Members

Introduction

Like everything we do, we kept it simple (kis): it's a simple HTTP GET request API with JSON response.

Endpoint is:

https://www.kisreminder.com/api/schedule/

Authentication

Use email and key parameters to authenticate every request.
You can get the key from your settings page.

Parameters

All of the following parameters are mandatory and should be url-encoded in the query string, eg:

https://www.kisreminder.com/api/schedule/?email=john.doe%40example.com&key=696e962eb5a7b1af82df31b53c6cf4&(...)

Parameter	Description	Example
email	Your email address. Used for authentication	[email protected]
key	The secret key obtained from your account's settings. Used for authentication	696e962eb5a7b1af82df31b53c6cf4
reminder	The actual text of the reminder	Call mom and wish her a happy bibrthday
timezone	Your local timezone, see list.	America/New_York
datetime	The time of the reminder, ie: when do you want the reminder email to be sent to you. Format: yyyy-mm-dd hh:mm (time is in 24h format)	2024-11-22 13:22

Note: setting a recurring reminder is not available from the API at the moment.

Example of a request

GET https://www.kisreminder.com/api/schedule/?email=johndoe%40example.com&key=696e962eb5a7b1af82df31b53c6cf4&reminder=Call+mom+and+wish+her+a+happy+bibrthday&timezone=America%2FNew_York&datetime=2024-11-22+13%3A22

You can try it in your browser, but obviously, you'll get a erroneous response as the authentication will fail.

Response

Response is in JSON format.

key	Description	Example
success	Boolean (true/false) to state whether the reminder was scheduled or not.	true
id	String identifier of the reminder. Only exists when success=true.	JZNvwsLL5
errors	Array of errors, each consist of two keys: id and description Empty when success=true

Example of a successful response

{
    "success": true,
    "id": "JZNvwsLL5"
}

Example of a erroneous response

{
    "success": false,
    "errors": [
        {
            "id": "datetime",
            "description": "You can only schedule future reminders."
        },
        {
            "id": "key",
            "description": "Secret key is invalid."
        }
    ]
}