Here’s a real-world example that walks you through getting started using webhooks in action with your data. For someone with programming experience, it should be quick to set up. This example uses Node.js to build a script to process webhook events.
This guide assumes you have:
An overview of the steps we’ll be working through:
Heroku is a platform for hosting applications in the cloud. They’re well-known service and have good guides for new users. It’s possible to deploy a small application to Heroku for free. That’s what we’re working toward.
In the course of building the webhooks functionality, we created an application for testing. It’s called polis.js. The application receives HTTP POST requests and writes the contents to STDOUT. It’s the application we’ll set up as a webhook endpoint.
In your terminal:
git clone https://github.com/fulcrumapp/polis.js.git
git push heroku master
In your terminal:
This will open the site in your browser. The page should say polis.js is running.
In your browser:
API Webhooksin the list of links for that org’s settings
polis.jsas the webhook’s name
heroku domainscommand above
Now that the webhook has been created, we can start using it.
Create a new app and a record within Fulcrum. Since we have an active webhook within our organization, an event is created for both the form and record we made. Each event generates requests for each of the webhooks in our org. Since we only have one webhook now, one request is made for the form and one for the record. Those requests are made to the webhook’s URL automatically. So now, we should expect that our Node.js app has received the requests. And we can check that next.
Now, let’s check out the application on Heroku to make sure it received the webhook event requests.
In the terminal:
polis.jsfolder, if necessary
Example of a
record.create event payload:
Note that one caveat of these logs is that they might not be in order. You’ll see that some of the lines won’t appear in the order the application actually wrote them out. But the logs do still show that we received the webhook event request.
We’ve successfully set up a webhook endpoint, created a webhook in Fulcrum, and seen how they are connected.
Give yourself a pat on the back!
Now, you can check out the Webhooks Developer Documentation and begin building more sophisticated applications to extend Fulcrum!