Subscribe to this blog to receive periodic product release announcements for developers and tips and tricks for using API.

Introducing The Webhook API (beta)

The Webhook API is now available and is in beta! To participate in the beta, contact the Blackbaud SKY Developer team. We will update the new changelog with any additions or improvements to the API.

The Webhook API enables 3rd-party applications to subscribe to specific events that happen within the Blackbaud system.

For example, when constituents change their contact information, we can notify your SKY application through a Webhook API subscription to the constituent address changed event. When you subscribe, your application provides an endpoint URL to be called when a constituent's address changes. In Blackbaud environments where your application has been enabled, when an event happens, we send the request to that endpoint. Your application then inspects the request payload to determine if it should take an action in response.

Instead of implementing a time-interval polling mechanism to check if the address information has changed, a subscription to a webhook event enables us to send you notifications when subscribed events occur.

For more information, see our Webhook API documentation. Stay up-to-date on the latest by bookmarking the new Webhook API changelog!

Posted by Lindsey Rix on May 19, 2020 11:40 AM America/New_York

Leave a Comment

Log in to post a comment.

The webhook API Endpoint Reference page is missing: Sorry, we can’t find the page you are looking for​
 
  • Posted Tue 19 May 2020 01:27 PM EDT
Steven Cinquegrana‍ make sure you are logged in and then try to refresh the endpoint reference page. It's not an open beta. 
  • Posted Tue 19 May 2020 01:40 PM EDT
Lindsey Rix‍ I was logged in, tried refreshes, etc. It suddenly appeared after a few redirects from a different link.
  • Posted Tue 19 May 2020 02:05 PM EDT
Steven Cinquegrana‍ Good to know you're logged in now! Perhaps there's some fun browser caching at play. Either way, hope you are good to go now. 
  • Posted Tue 19 May 2020 02:06 PM EDT
Lindsey Rix‍ Could you possibly relax the need for cred on the two API Definition links? We use these to generate code from a utility app so having open access to these is useful.
  • Posted Tue 19 May 2020 05:07 PM EDT
Steven Cinquegrana‍ Can you reply to Ben's email with more specificity about which two links? Because this is an invite-only beta, I know the endpoint reference requires you to be part of a subscription, but it doesn't require any other credentials than being logged in. 
  • Posted Tue 19 May 2020 05:15 PM EDT
Lindsey Rix‍ Ok, I've copied Ben Wong‍ in. But if you go to the EPR you'll see right there on the page "API Definitions" under which there are "Open API" (aka Swagger) and "WADL". Also, no matter what we try, we're getting Invalid Webhook URL error when trying to create a subscription. Even using your own examples.
  • Posted Tue 19 May 2020 06:34 PM EDT
Hi Steven Cinquegrana‍, we're working on making the endpoint reference visible to the public very soon. The API definition links will then be available to reference from your app. I can work with you directly on the error you're seeing.
  • Posted Wed 20 May 2020 09:28 AM EDT
Ok, thanks Ben Wong‍. I replied to your email yesterday with the invalid webhook error details.
 
  • Posted Wed 20 May 2020 12:15 PM EDT