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 Notifications followed by Integrations, then click New Profile. Select 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 Notifications>Contacts. The profile is assigned to the Push Notifications field within the contact group. 

custom-postback-config.png

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.