Chapter 1: Configuration

Webhooks.org defines web hooks as "user-definable callbacks over HTTP."

Web hooks in Sitellite allow you to specify one or more URLs that will receive an HTTP POST request when certain workflow events occur. For example, your external applications can receive notifications whenever a page is added, modified or deleted. They can log this info or implement additional workflow actions based on it.

An example might be an external search tool that gets a notification whenever a page changes so it knows to re-index the page. Another example would be an external site that is notified of news stories as they're added to your site, possibly for syndication purposes. 

To specify the URLs you would like to POST to:

1. Log into Sitellite and go to the Control Panel.
2. Under the Admin menu, choose Applications.
3. Click on the Edit icon next to the Content Manager application.
4. Enter your URL(s) into the Web Hooks text box, one per line.
5. Under the "Web Hooks Authorization Key" field, click Auto-Generate to generate a random authorization key. Save this value for later.
6. When you're finished, click Save.

Now that you've specified your post-back URLs, you still need to enable the web hooks workflow service. To do this:

1. Go to the Control Panel.
2. Under the Admin menu, choose Workflow Services.
3. Under the Content Manager heading, check the checkbox next to Web Hooks.
4. Click Save. 

You're now ready to program your POST handler.