This assumes you’ve read the Webhooks Introduction.
Since webhooks are HTTP-based callbacks, our Fulcrum servers make HTTP POST requests to web servers whose URLs you give us. This means you need an endpoint that can receive these POST requests.
It’s likely you will want to write your own endpoint to implement functionality custom to your organization. If this is the case, see the Webhooks Developer Documentation for more details.
In the process of adding the webhooks functionality to Fulcrum, we built several applications that are webhook endpoints. We’ve taken some of these and created comprehensive walk-throughs to give a complete example of how to get webhooks working.
We’ve made other applications available to you as well. Their links are below. You can use the applications as a foundation to build on or simply illustration on how you might create your own.
To get started, pick one of these applications and follow the steps in the project’s README to get it running. Once you’ve done that, remember the URL where the application is running. You will use it in steps down below.
Once you have an endpoint running, you can create a webhook within Fulcrum with the following steps:
API Webhooksin the list of links for that org’s settings.
Once a webhook has been created and is active, it will begin to receive HTTP POST requests at its URL as events occur within the organization.
Webhooks are active by default. This means that new events will automatically be sent to the webhook’s URL via an HTTP POST request. If you wish to leave the webhook in the organization but prevent any events from being sent to that URL, set it to be inactive. To do this, when editing a webhook, simply uncheck the
Active? checkbox and save the webhook.
Please see the Webhooks Developer Documentation for more details on how to receive, use, and respond to these POST requests.