Using Webhooks with Precog

A webhook is a way for one application to automatically send a message to another when a specific event happens. Instead of constantly checking for updates, the receiving application gets notified in real time.

Here’s how it works:

• The sending application (in this case, Precog) is set up with an event (e.g., a data load completes).
  
  
• That event is linked to a URL provided by the receiving application (an API endpoint).
  
  
• When the event occurs, Precog immediately sends a message to that URL.
  
  
• Messages are usually sent as HTTPS POST requests with data in JSON format.
  
  

Think of it as an API callback, but instead of requesting information, it pushes a notification.

Using Webhooks with Precog

Precog sends a webhook notification whenever a standard data load completes (any load after the initial load for a connector).

To set this up, you’ll need:

• A valid URL from the receiving application.
  
  
• Authentication credentials for the receiving app, included in the request headers.
  
  
• Use the Request Body field in Precog to define what information Precog sends with each notification. You can customize the message pushed to the receiving application.

With webhooks, Precog can notify your downstream systems in real time, so they’re always up to date.