What Is GivePanel Webhooks
GivePanel Webhooks allow you to fire events in realtime into your own systems using a webhook url (such as a Zapier webhook url).
Webhooks are a powerful tool that allow apps and systems to communicate with each other in real-time. In this article, we will explore what webhooks are, how they work, and how you can use them to connect GivePanel with your other systems to fire the following events:
Fundraising Amount Reached - This webhook fires when a fundraiser reaches a custom amount raised of your choice.
New Registration - This webhook fires when a new registration is created.
New Fundraiser - This webhook fires when a new fundraiser is created with our custom 1-Click fundraisers.
Webhooks are automated messages that are sent from apps when a specific event occurs.
These events can range from a supporter registering for your Facebook challenge to a new fundraiser being created. When these events happen, the app will send a message, also known as a payload, to a unique URL.
This URL acts as the app's phone number or address, allowing the message to be delivered to the intended recipient.
So why are webhooks important? Webhooks allow apps and systems to share real-time data with each other. This means that when an event occurs in one app, the other app can immediately receive the information and take action. This eliminates the need for manual data entry or constant checking for updates, making processes more efficient and streamlined.
How To Enable GivePanel Webhooks in Your GivePanel Account
Contact the support team using the support widget in the bottom right of your account to discuss getting this enabled in your account.
Once live, within the integration section of your account, you will see a ''GivePanel Webhooks'' widget.
Click ''Settings'' to expand GivePanel Webhooks, this is where you can add your webhooks url such as a Zapier Webhook Url.
Setting Up A Zapier Webhook URL
Zapier is one of the more universal and popular tools for facilitating data transfer via webhooks. Below we explain how to create a webhook url in Zapier for adding into GivePanel. Once set up, you can then fire an event (e.g. a new fundraiser event) into Zapier for sending to other platforms such as google sheets or a CRM.
In Zapier, click ''create'' and then ''Zaps''.
Then click into ''Trigger''.
Then select ''Webhooks by Zapier''.
Zapier will ask you to choose an event (this is what starts the Zap). Here you will want to select ''Catch Hook'' and then click ''Continue''.
Then you will be taken to the ''Trigger'' section. This is where you can define a subsection of data to export. This section can be skipped by clicking ''continue'' as it isn't required. You will then be taken to the ''Test'' section.
Testing New Registration Webhook Event
You'll then be taken to the ''Test'' section. This is where Zapier will provide you with your custom webhook URL (it is this url that can be added into GivePanel webhooks)
Next add the custom zapier webhook url into the ''New Registration'' field.
Once you've added a webhook url into GivePanel, click ''update webhooks'' in GivePanel to save.
To finish your test, submit a GivePanel registration.
Then head back into Zapier and click on ''Test trigger''.
If it is working correctly, Zapier will preview the event data that it has received.
This is an example of a new registration event:
Below the preview of data, select ''continue with selected records''.
Next Zapier will invite you to set the ''Action''. For example, the action could be to send the data we receive via this webhook into a google sheet.
From the drop down, you can select the app or platform you would like to send the data to each time the new event is fired.
In this example, we are sending the data to google sheets so we have selected ''Google Sheets''.
You can then select the event which is performed when the Zap runs. In this example, each time we receive a new registration, we would like the data to be added into a new row in the google sheet.
Once you've selected your action, click ''continue''.
You will then want to select the google account that contains the desired google sheet you want to send the data to.
Then you will be invited to select the google sheet from your google drive and map the data to the columns in the google sheet.
Finally, you can click ''test step'' to make sure the data is added to your desired google sheet correctly.
Once you're happy with everything, click ''Publish''.
Testing New Fundraiser Webhook Event
You'll then be taken to the ''Test'' section. This is where Zapier will provide you with your custom webhook URL (it is this url that can be added into GivePanel webhooks)
Next add the custom zapier webhook url into the ''New Fundraiser'' field.
Once you've added a webhook url into GivePanel, click ''update webhooks'' to save.
To finish your test, submit a test GivePanel Custom 1-Click fundraiser.
Then head back into Zapier and click on ''Test trigger''.
If it is working correctly, Zapier will preview the event data that it has received.
Below the preview of data, select ''continue with selected records''.
Next Zapier will invite you to set the ''Action''. For example, the action could be to send the data we receive via this webhook into a google sheet.
From the drop down, you can select the app or platform you would like to send the data to each time the new event is fired.
In this example, we are sending the data to google sheets so we have selected ''Google Sheets''.
You can then select the event which is performed when the Zap runs. In this example, each time we receive new fundraiser data, we would like the data to be added into a new row in the google sheet.
Once you've selected your action, click ''continue''.
You will then want to select the google account that contains the google sheet that you want to send data to.
Then you will be invited to select the google sheet from your google drive and map the data to the columns in the google sheet.
Finally, you can click ''test step'' to make sure the data is added to your desired google sheet correctly.
Once you're happy with everything, click ''Publish''.
Testing Fundraising Amount Reached Webhook Event
You'll then be taken to the ''Test'' section. This is where Zapier will provide you with your custom webhook URL (it is this url that can be added into GivePanel webhooks)
Next add the custom zapier webhook url into the ''Fundraising Amount Reached'' field and choose the custom amounts that you'd like the webhook to fire on. For example, if you'd like this webhook event to fire once the fundraiser has raised at least $£€1, select ''1''.
Once you've added a webhook url into GivePanel and set the custom amounts, click ''update webhooks'' in GivePanel to save.
To finish your test, submit a test GivePanel Custom 1-Click fundraiser and make a donation that meets one of the custom amounts. The support team can upload dummy donation data for you that we can remove after.
Then head back into Zapier and click on ''Test trigger''.
If it is working correctly, Zapier will preview the event data that it has received.
Below the preview of data, select ''continue with selected records''.
Next Zapier will invite you to set the ''Action''. For example, the action could be send the data we receive via this webhook into a google sheet.
From the drop down, you can select the app or platform you would like to send the data to each time the new event is fired.
In this example, we are sending the data to google sheets so we have selected ''Google Sheets''.
You can then select the event which is performed when the Zap runs. In this example, each time we receive new amount reached fundraiser data, we would like the data to be added into a new row in the google sheet.
Once you've selected your action, click ''continue''.
You will then want to select the google account that contains the google sheet.
Then you will be invited to select the google sheet from your google drive and map the data to the columns in the google sheet.
Finally, you can click ''test step'' to make sure the data is added to your desired google sheet correctly.
Once you're happy with everything, click ''Publish''.
List of all the data fields sent by each webhook
In order to test these with Zapier - each event needs to be triggered after the webhook URL has been added to GivePanel. It should then be available as a record in Zapier with the relevant data fields as below
Fundraiser Amount Raised
First Name - firstName
Last Name - lastName
Display Name - displayName
Created On - creationDate
Fundraiser URL - permalink
Platform e.g. Facebook - platform
Phone - phone
Charity ID - charityId
Fundraiser ID - fundraiserId
Triggered Amount i.e. the custom target that was set in the webhook - targetAchieved
Total amount raised before update - oldAmount
New fundraiser total amount raised - newAmount
Address1 - address
Address2 - address2
Zip/Post Code - zip
Optin - optin
New Registration
First Name - firstName
Last Name - lastName
Created On - creationDate
Event ID - eventID
Email - email
Phone - phone
Charity ID - charityId
Address1 - address1
Address2 - address2
City - city
Country - country
State - state
Registration ID - id
Zip/Post Code - zip
Optin - optedIn
New Fundraiser
First Name - firstName
Last Name - lastName
Created On - creationDate
Fundraiser ID - campaignId
Fundraiser URL - permalink
Email - email
Phone - phone
Charity ID - charityId
Address1 - address1
Address2 - address2
City - city
Country - country
State - state
Unique ID - id
Zip/Post Code - zip
Optin - optedIn