Data structures


Each cronjob contains these members:

Name Type Description
id integer ID
group integer Group ID, null means "None"
expression string Cron expression (crontab syntax e.g. 0 12 * * 1-5 or English description e.g. 1 day; 65 minutes; 1 min 30 sec)
timezone string Time zone
url string URL to call
httpMethod string The HTTP Method to send HTTP request to your URL.
httpHeaders string Plain HTTP headers to send to your cronjob URL. Use new lines as delimiters, e.g.
X-API-Key: 123ABC456XYZ
Header2: test-value
postData string The data to POST to your URL
fail integer Number of consecutive failures
status integer Status code, 0 means "active"
name string Name of cronjob
notify integer Notification settings
points integer Points, number of executions per day

Status codes

Here's the list of cronjob's status codes:

Value Name Description
0 STATUS_ACTIVE Cronjob is active and running
1 STATUS_DISABLED Disabled by user
2 STATUS_EXPIRED Disabled due to account expired
3 STATUS_INACTIVE Disabled due to not enough account points
4 STATUS_FAILED Disabled due to many consecutive failures

Notification settings

Here's the list of notification setting codes:

Value Name Description
0 NOTIFY_NEVER Never send you any notification
1 NOTIFY_FAILURE Notify you when cronjob fails
2 NOTIFY_ALWAYS Notify you when cronjob is executed
3 NOTIFY_DISABLED Notify you only when cronjob disabled because of multiple consecutive failures

Cron execution result

Each cron execution results contains these members:

Name Type Description
result array An array contains multiple values, see below.

result contains these members:

Name Type Description
url string The actual URL that our bot sent HTTP request to.
output string Your cronjob output, including HTTP headers and body. Only first 4KB and last 1KB, the remaining is truncated.
downloaded integer Total output size (in bytes).
httpStatus integer HTTP status code e.g. 200
error string Error message, if any.
message string System message, if any
ip string Destination IP.
source_ip string IP address of the bot that process your cronjob.
time integer Unix timestamp of scheduled time.
startTime decimal Unix timestamp of starting time with milliseconds.
executionTime decimal Total execution time, in seconds.
status integer Execution status, 0 means "success"


Each group contains these members:

Name Type Description
id integer ID
name string Name
autoDelete integer Automatically delete stopped (one-time) cronjobs. 0 for never; 1, 3, 7, 15, 30 for days.
contacts array An array/collections of contacts that receive cronjob notifications from this group.


Each contact contains these members:

Name Type Description
id integer ID
name string Name
type integer Contact type: 0 for email, 1 for Slack URL, 2 for web hook URL.
target string Contact email / slack URL / web hook URL

Supported timezones

There are two types of timezone: real timezone e.g. Europe/London, and displaying timezone e.g. (UTC+1) Europe/London. Our data structures and parameters' timezone field works with real timezone only.

You can get the list of supported timezones at server.timezones.

Warning: If you send request using URL parameters, please escape your timezone (and all other variables' values) using a URL encoding function e.g. PHP's rawurlencode.