Integrating with Zapier

Learn how to send AuditWolf webhook events into Zapier

Through AuditWolf webhooks, you can send important events that AuditWolf detects in your Azure infrastructure directly into Zapier, so you can then automate workflow to meet your specific business needs. This could be anything from sending messages to your CloudOps crew via Microsoft Teams or Slack to opening or closing tickets in ServiceNow. You're only limited by your imagination... and an understanding of how to setup Zapier to work with AuditWolf. 

The rest of this document explains how to do just that.

Step 1 - Login to Zapier

To start, head over to https://zapier.com/app/login/ and sign in. To use AuditWolf with Zapier, you will need to have a PREMIUM license of Zapier to use webhooks. 

Step 2 - Setup a new 'Zap' to work with AuditWolf

Start by clicking the "Make a Zap!" button on the top right side of the screen...

In the first step of the Zap, type in "webhook"...

Select the "Webhooks by Zapier" app...

... select "Catch hook" as a Trigger Event and then click the "Continue" button... 

Zapier will now present configuration to "Catch Hook". As part of this dialog they will generate a custom webhook URL. Copy that to the clipboard and then head over to the AuditWolf Portal.

From the AuditWolf Portal, select Settings from the menu on the left...

Select the "Webhooks" tab and then click "Add Endpoint" button ...

When prompted, complete the fields in the dialog. Make sure you copy the entire Zapier URL and paste it in the Callback URL field. Select at least one subscription you wish to monitor and select the desired events you want to track. In this workflow, we are tracking "Issues detected or resolved", which will send task.createtask.suppress and task.complete events.

Now click the "Send Test" icon beside the Callback URL. This will send a test message to Zapier and link AuditWolf to Zapier. 

Hit "Add Endpoint". It will save the webhook and generate a new signing secret you can use to verify the digital signature of events sent by AuditWolf to guarantee authenticity... 

NOTE: This is the only time you will see that signing secret. Once you hit "Close" that value will never be shown again. If you need a new signing secret you will be forced to create a new webhook and delete the old one.

For more information on advanced configurations like verifying the security and authenticity of AuditWolf events, please review the AuditWolf Webhooks Reference guide.

Head back to your Zap in Zapier and hit the blue "Continue" button. When prompted click "Test & Review" to have Zapier process your sample test payload you send from AuditWolf....

Once Zapier has processed the sample payload, you can see the hook linked. You can expand the "Hook A" to see how Zapier processed the message...

Click "Done editing" to complete linking the AuditWolf webhook event to Zapier...

At this point you can continue on setting up your Zap. Let's send an email using Zapier's email service. In the search field, type "Email by Zapier" and select it...

In the "Action Event" select "Send Outbound Email" and click "Continue"...

Fill in all the fields related to sending the email. Note that Zapier exposes all the fields in the AuditWolf event directly when you click on the "Insert field" icon to the right of the text field. You can use this to customize your email the exact way you like it.

When prompted to Send Data, click "Test & Continue". Once a test email is sent successfully, click "Done Editing". You will be asked to turn on your zap...

That's all there is to it. Now turn on your Zap!!!

Step 3 - Enjoy the integration goodness...

That's it. Any time a webhook is triggered that matches your configuration AuditWolf will send a message to your callback URL into Zapier. Where you take it from here is only up to your imagination. If you make something cool, please let us know at help@auditwolf.com so we can share your awesomeness with the team!