Configuring Custom Postback URL

The Custom Postback URL will allow you to push alerts to any third party system in which you can expect to receive an application/json encoded payload in the body of a request.

In order to activate the Custom Postback URL integration within your Uptime account, you will go to Alerting>Push Notifications then choose Custom Postback URL as the provider type when adding a new push notifications profile.

The following describes the fields shown when configuring the Custom Postback URL integration within your Uptime account:

  • Postback URL: Enter the URL which will receive data via the postback.
  • Alias: The reference name you desire to assign to your Custom Postback URL profile. It can assist you with organizing multiple provider profiles within your Uptime account.

*Once you've configured your Custom Postback URL profile, you will need to assign the profile to a contact group located under Alerting>Contacts. The profile is assigned at the Push Notifications field within the contact group. 

Additional Custom Postback URL Configuration Notes

Servers can expect to receive these keys in the HTTP POST in a JSON serialized string:

(
   [check_url] => http://google.com
   [check_type] => HTTP(S)
   [server_name] => google.com
   [check_name] => google.com
   [locations] => Array
   (
      [0] => USA
   )
   [check_uptime_api_url] => /api/v1/monitoring-checks/6257/
   [check_id] => 6257
   [date] => Aug. 18, 2015, 6:40 p.m.
   [state] => 'UP' or 'DOWN'
   [output] => Zero Bytes Received
)

An example PHP program will pick up the data and unserialize it for you to do with as you need with your custom logic:

<?php
file_put_contents('output.txt', print_r(json_decode(file_get_contents('php://input')), true));
?>

The above test script will log the unserialized payload to a file once received.