All Articles

How To Set Up Webhooks

With Webhooks you don’t have to wait any amount of time to get the data you need! You can set up your webhooks by navigating to your Settings page and selecting the Webooks header. Webhooks are available for our Business Plus and Enterprise users.

Before You Begin
Using webhooks is an advanced feature in UpKeep and requires some technical knowledge. For a quick guide on what a webhook is, please refer to this link here.

Why Use Webhooks?


With using webhooks, you don’t have to wait any amount of time to get the data you need. Webhooks enables you to push data in real-time and sync their applications with UpKeep as events are taking place within their account.

For example, for every work order that is closed, the total cost can be sent to Quickbooks as soon as the work order status is changed to “Completed”.  Any event within your UpKeep account can trigger the sharing of your data in an instant!

How to Create a Web Hook

Step 1: Create a “Catch Hook”
This will be the endpoint which will get triggered by events and sent your event data. This can either be a custom endpoint that your engineering team creates or you can use a more simple solution like Zapier to help create one.

Step 2: Copy the URL created from your webhook into your clipboard (you’ll need it for Step 4)

Step 3: Send data from UpKeep to that webhook

Navigate over to the settings page in UpKeep and select “Webhooks”
https://app.onupkeep.com/web/settings/webhooks

On this page, press the “Add Webhook” button! You’ll create a title, and then select “Let me choose individually” 

Step 4: Paste in the URL from step 2 into the “Endpoint” 

Step 5: Activate your Webhook

From here you’ll then want to create the webhook, and then click in and press “Enable”. Once the green light is on, you know your webhook is up and running!

Step 6: Test out your webhook
Now that you’ve created a webhook every time a work order status has been updated, let’s go ahead and change the status of a work order to see if data is getting sent over!


Step 7: Create Actions Based Off Of Events triggered from that webhook

Now every single time a work order status is updated, the URL endpoint will be sent data about that work order. This will then enable you to do things like create better two-way integrations with different applications!

One simple thing you can do is send a slack message each time a work order status has been changed!