JustGiving is one of the most popular peer-to-peer fundraising tools, and is ideal for challenge events, allowing donors to sponsor their friends and family.
With the JustGiving app for Beacon, you can rest assured that all of your data is automatically imported into your Beacon database, structured and stored in the way that's right for you.
When a supporter creates a new fundraising page for you in JustGiving, Beacon will automatically add them and their page as records in your account.
When someone makes a donation in JustGiving, Beacon will automatically add the donation as a Payment in Beacon.
If the donor allowed JustGiving to pass their data to your organisation, then the donor will automatically be added as a Person in Beacon, allowing you to see the history of all of their payments in your database:
Additionally, Beacon can import the fundraiser responsible for each donation, setting them in the 'Fundraiser' field on the payment record. Helpfully, this allows you to quickly see how much a person has fundraised for you when viewing their person record:
Events & appeals
When importing fundraising pages and donations, Beacon will create events in your database for the JustGiving events that don't already exist in Beacon:
Beacon will also create a campaign in your database for each appeal you have in JustGiving, allowing you to easily keep track of the donations made across each one:
Installing JustGiving takes a little longer to set up than other Beacon apps. This is because JustGiving requires you to:
Create an "app" in their developer portal
Get your app "upgraded" by the JustGiving data API
Add your details into Beacon
1. Create a JustGiving app
First up, you need to sign up for a JustGiving developer account.
Once you've created an account and verified your email, head to My Account > Applications.
You'll see that JustGiving has created an app already for you:
Woohoo! We're not done yet though...
2. Get your app approved by JustGiving
For this app to be used with Beacon, it needs to have it's "plan" changed by the JustGiving developer team to have access to JustGiving's data API.
Open your app, and then click Review/Change:
This should open a dialog. Then click the JustGiving data API link on the left hand side, and then scroll down and click Request plan change.
After you've requested a "plan change" with JustGiving, the JustGiving developer team will review your request, and should grant you access within a few working days. You'll be notified by email when this happens.
3. Add your details into Beacon
Now you have your approved JustGiving app, you can connect with Beacon! Head over to Apps > Directory and click Install on the JustGiving app.
You'll immediately be prompted to connect with JustGiving:
When connecting, you will need to add your Charity ID (can be found in your regular JustGiving account Settings > Edit Charity Details):
You'll also be asked to provide your "App ID". This is for the developer app you just created, and can be found in your list of JustGiving developer applications:
The email and password fields are the usual details that you use to login to JustGiving with.
Once you've entered all of the details, click Connect. Review the settings and then click Save integration.
Nicely done! JustGiving is now connected to your Beacon account!
Frequently asked questions
Does Beacon import all of my JustGiving data, or just donations that happen in the future?
Our JustGiving app is forward-looking. It only imports donations that are made after the JustGiving app is installed, and only imports fundraisers for fundraising pages that are created after the JustGiving app is installed.
Going forwards we will be building a system to "bulk-import" all of your existing JustGiving data. For now though, you can use our CSV import template to import your existing data.
Why is there a delay in donations being imported into Beacon?
A limitation of JustGiving's data API is that it only makes your donation data available after it has been paid into your bank account. JustGiving typically pay you every week or so, for donations that have recently been made.
Once JustGiving pay you, the donations included in the payment will be imported into Beacon a few days later. Usually this is 4 days later, but can be up to 7 days.
We agree, this delay isn't ideal. We've added this feedback to JustGiving's ideas bank. Please add your vote and comments to suggest this to their product team.
How quickly are new fundraisers added to Beacon?
When someone has created a new fundraising page, JustGiving sends their details to Beacon overnight (around 5am!) so you should see any new pages added as Fundraising pages and fundraisers themselves added as People within 24 hours.
How is Gift Aid handled?
At the moment, we assume that any donations marked as "Gift Aid Eligible" in JustGiving have their Gift Aid claimed by JustGiving. These payments will be imported into Beacon marked as "Gift Aid claimed", so won't be added to claims in Beacon.
How is contact consent set?
If a donor or fundraiser opts-in to provide their data to you in JustGiving, the data will be available for Beacon to import. We allow you to choose how to set contact consent for imported donors and fundraisers (which depends on your consent statements in JustGiving):
Does Beacon import individual fundraising pages?
Yes! To import fundraising pages and have donations linked to them, make sure you enable 'Import fundraising pages?' and have selected 'Fundraising pages' in the 'Import related information?' dropdown of the donations section of the JustGiving app settings in Beacon.
Does Beacon import team pages?
No. It's not possible to donate directly to a team page in JustGiving, only to an individual page. Since team pages can't receive donations, they won't be created in Beacon.
What happens if I change my JustGiving password?
If you change the password of the JustGiving account associated with your Beacon account then you will need to update these details in Beacon. To do this you will need to disconnect the JustGiving app in Beacon by removing the connected account...
...and then clicking Save integration:
Once you've saved, reconnect your JustGiving app as normal and all your configuration settings will be restored!
Does Beacon support JustGiving's "custom codes"?
Not currently. Custom codes are most often used to set Funds and Campaigns. These can be managed within Beacon using workflows or bulk updates. If you have other uses for custom codes, please let us know more!
How should I handle Gift Aid paid out from JustGiving?
Beacon does not create any separate payment or payout records for Gift Aid amounts that JustGiving has claimed on your behalf. We suggest reconciling these outside of Beacon as there is often not a need to connect those Gift Aid amounts to the original payments. If you'd like to report within Beacon on Gift Aid raised we've got some suggestions with for smart-fields here. Reach out to us in support if you've got some more complex processes for how you manage Gift Aid allocation.
How does Beacon deduplicate records brought in through JustGiving integration?
Beacon will deduplicate records in the following ways:
Event - Event's name
Fundraising page - ID
Payment - ID
Person - Name & Email
JustGiving subscriptions don't have an ID available in the API so we'll create IDs from scratch for these!