nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

What would be the best way to receive updates to a server whenever a constituent completes a donation form?

Tyler Atkinson

We are looking to send some of this data to an external application (name, phone number, etc.) when someone fills out a donation form. What would be the best way to accomplish this?

Find more posts tagged with

Comments

Chris Rodgers

Hey Tyler,

Just to clarify, are these donation forms for Raiser's Edge NXT?

If so, you have at least 2 options:

Webhooks. Use the Webhook API to subscribe your SKY Application to the `com.blackbaud.gift.add.v1` event in a given Blackbaud Environment. Whenever the new gift is added through the donation form, your application/server will be sent a webhook message.
Polling. Depending on your tech stack, you could schedule your Application to periodically check for new gifts by using the `date_added` filter and sort options to get the most recent gifts added since your last job run. Our “Headless Data Sync” code sample is an example of this model for polling new constituents.

If you need to know about new donations as soon as possible, webhooks may be the correct solution. If you're ok with some latency (polling every 5+ minutes) or you expect a very high number of donations (that's the goal, right?), polling may be the better way to go since you can choose when to ingest new donations and you won't have to worry about your application being flooded by webhook requests.

Hope this gives you enough information to start.

- Chris

Tyler Atkinson

Okay, thank you Chris, I will give that a try!

Shanmukha K

@Chris Rodgers
I'm currently using the webhook to receive donation information in real time. However, the data provided is quite limited—it only includes the gift_id and constituent_id. I'm trying to determine how to link the gift to the specific donation form(Id) it came from. Could you please help me understand how to establish this relationship?

Alex Wong

@Shanmukha K
webhook meant to give you the system record id only, you are then to use this id to call onto the SKY API endpoint of Get Gift or Gift Constituent to gain more data of the gift/constituent.

Shanmukha K

@Alex Wong That I understood but in the gift api also there is no information where this gift belongs to in my case donation form id. Please help me how can I relate these both.

Alex Wong

@Shanmukha K
if you are talking about RE NXT donation form, I do not use that platform for donation right now so I can't speak for it. However, someone has previously stated that donation form info is added to gift custom fields, if true, you can use the list gift custom fields.

Shanmukha K

@Alex Wong
What's the use of getting the donation form name if it is not unique. Any way I tried the gift custom fields but didn't get any donation form name.

Chris Rodgers

Hey @Shanmukha K, you're right. I confirmed with the team that manages the Gift API that Donation Form details are stored with the gift but that the Gift API doesn't currently provide this. You can add a submission to our Idea Bank for this request. Hopefully the team will be able to enable this soon.

Shanmukha K

@Chris Rodgers
Could you help us understand how to associate a gift with its corresponding donation form ID? We’d like to know how Raiser’s Edge maps incoming donations to the specific donation form they originated from.