A webhook is a user-defined HTTP callback that enables you to create a real-time conversation between a client and a server whenever a data event occurs. In other words, by setting up a webhook with Impira, you’re asking Impira (the “client”) to let you (the “server”) know about any updates or changes to your dataset. You provide Impira with a way to reach you (via a unique webhook URL) whenever a new data event occurs. By having a webhook instantly “push” new data over to you means you won’t have to check for updates yourself — you let the updates come to you.
Okay, let’s get webhooked
If your receiving application allows for webhooks, find that application’s unique webhook URL.
NOTE: This URL’s location may be different from the one used in this guide.
1. Have your unique webhook URL handy by copying it to your clipboard.
2. Go to Impira and select your collection.
3. Click the drop-down arrow next to the collection’s name (right below the search bar) and select Configure automations.
4. Click + on the right side, beside Destinations and select Webhook.
5. Paste in your webhook URL and choose Submit.
And you’re done. With just a few steps, you’ve linked Impira with your receiving application by creating a webhook. Any time you add files or make changes to the data in this collection, Impira will run an API request and send updates to the URL you provided.
Checking on your webhook
Any time you want to see the status of any recently run webhooks, go to Configure automations (see step 3) and select View next to your webhook. This is a good way to check when the last time a webhook was run or if there were any errors, etc.