Integration Summary
Product | |
Method | Pull (Timer) |
Frequency | Every 12 Hours |
Articles |
|
Demonstration Video
Supported Modes
Logic is required to map JustGiving notifications to your Salesforce data. To quickly and easily do so we recommend using one of the supported MoveData Extensions.
Fundraising and Donations | ✔ |
Ticketing and Commerce | ✘ |
Forms | ✘ |
Setup
To set up JustGiving you will need to know your Charity ID and Consumer and Data App IDs.
To access your Charity ID, log into your JustGiving Admin and navigate to
Settings → Your Charity → Edit charity account detailsTo access your Consumer and Data App IDs, contact JustGiving Support (support@justgivingdeveloper.zendesk.com) requesting access to the Data and Consumer APIs for Production data
You will need to create your JustGiving Integration in MoveData. To do this, open the MoveData app and select the Integrations tab. Click New Integration and select JustGiving from the list of available integrations. Add a Name and click Save.
MoveData JustGiving Configuration Screen
Enter your Charity ID and Data and Consumer App IDs, as well as the username and password you use to access JustGiving. Referring to the JustGiving Configurable Options complete your configuration (if in doubt we recommend using the default options). Click Save to continue.
From this point, MoveData will request new information from JustGiving every 12 hours.
Configurable Options
Priority for Top-Level Campaign | A JustGiving fundraising page links optionally to a Campaign and Event. Often, a fundraiser will create a fundraising page that isn’t linked to an event such as the London Marathon. We have found that Campaigns are often more reliable to be used as the parent campaign for fundraising pages. |
Replace JG Charity Events with Top-Level Generic Campaign
(if JG Campaign is missing) | Toggle between using a top level campaign as “JustGiving” or an event / campaign (if present) |
Data Migration
Data Migration is available upon request. This is a custom service provided by MoveData and is delivered by MoveData Professional Services.
Records will only be imported if available via the JustGiving API
The older the records, the more likely the data and associated structures have minor variations and must be accepted as a risk to the success of any import
Additional Field Mappings
Where possible, all fields are mapped to the appropriate schemas. Often there are fields that do not fit explicitly into a schema and these are appended as custom fields. JustGiving Questions are dynamically added to Questions entries within the produced schema objects.
Other Resources
JustGiving Developer: https://developer.justgiving.com/
JustGiving API Reference: https://api.justgiving.com/docs
Reference
Below is a list detailing additional Custom fields sent as part of a notification by schema and object.
All Schemas
Accounts
No Custom Attributes
Contacts
No Custom Attributes
Campaigns
Event
Attribute Name | Description | Example |
| JustGiving Event Category |
|
| Campaign / Event Custom Code 1 |
|
| Campaign / Event Custom Code 2 |
|
| Campaign / Event Custom Code 3 |
|
| Is Overseas Flag |
|
| Is Promoted Flag |
|
| Is User Created Flag |
|
Team
Attribute Name | Description | Example |
| In Memoriam Date of Birth |
|
| In Memoriam Date of Death |
|
| In Memoriam First Name |
|
| In Memoriam Last Name |
|
| In Memoriam Gender |
|
| In Memoriam ID |
|
| In Memoriam Full Name |
|
| In Memoriam Relationship |
|
| In Memoriam Town |
|
| Appeal Name |
|
| Birthday Name |
|
| Campaign Code 1 |
|
| Campaign Code 2 |
|
| Campaign Code 3 |
|
| Fundraising Page Code 1 |
|
| Fundraising Page Code 2 |
|
| Fundraising Page Code 3 |
|
| Fundraising Page Code 4 |
|
| Fundraising Page Code 5 |
|
| Fundraising Page Code 6 |
|
Fundraiser
As above with team, plus:
Attribute Name | Description | Example |
| Event / Page Category |
|
| Event Name |
|
| Event Date |
|
| Event Expiry Date |
|
| Event Is User Created Flag |
|
| Event Completion Date |
|
| Event Category |
|
| JustGiving Team ID |
|
| JustGiving Page GUID |
|
| Page Activity Type |
|
| API Source |
|
| Page Summary |
|
Donation Schema
Recurring Donation
No Custom Attributes
Donation
| API Source |
|
| Initial Donation Payment Reference |
|
| Total Amount inc Gift Aid and Transitional Relief |
|
| Settlement / Payment Date |
|
| Reference for Settlement / Payment |
|
| Gift Aid Amount |
|
| Gift Aid Fee |
|
| Gift Aid Payment Date |
|
| Gift Aid Payment Reference |
|
| Third Party Reference |
|