Last updated
Last updated
We will do our best to provide simple, step by step instructions in this guide. If you need more information on how NeonCRM works, please check the following:
Login link:
You will need to go through the following process to setup the integration:
Setup a new user account within NeonCRM that would be used for the integration i.e. "TGB" or "The Giving Block"
Generate API token for that user.
Find your Organization ID
Enter your Organization’s API Key and organization ID and a token for that user into the NeonCRM page on The Giving Block .
Create a new user using the.
We recommend that you create a user named "The Giving Block", this will make it easy to identify
The user must have "User" level of permissions
API Keys are based on NeonCRM system user accounts. We recommend creating a new user account for each integration you enable. This makes it easier to disable a single integration at a later time. If you disable a user account with API access, all applications that depend on the account's API key will stop working.
Log in to your NeonCRM system. Navigate to: Settings cog > User Management.
Click New User. You can name this user anything you like, but we recommend naming the user something that distinguishes its use, such as API User.
Enable the API access for this user account. Click the toggle to enable. This will display your API Key. Copy this key.
Click Create User to complete the process of creating this user.
Your user will now appear in the User Management list. Remember, disabling this system user will terminate NeonCRM API access.
In NeonCRM navigate to: Settings cog > Organization Profile & Billing.
Scroll down to the "Database Information" section. Your Organization ID will be displayed here.
Your client Success Manager will enter your Organization’s API Key in the field “neonAPIKey”**
Your client Success Manager will enter your “Organization ID” in the field “neonOrgID”**
Your client Success Manager will Click “Save Changes”
(Clicking the “click here” link will bring you to these instructions)
Once you've successfully implemented The Giving Block/NeonCRM integration, things should "just work". You can watch Tim from Neon CRM giving a demo of the integration here:
A donor will donate cryptocurrency through The Giving Block's widget, this will create a new donor in NeonCRM using the donors 'Firstname', 'Lastname' and 'Email'. If the address is able to validate these will be added to the donor information.
Example Non Anonymous Donation:
Example Anonymous Donation:
A Donor Account will be created with the following data:
A Donation Record will be created with the following data:
Donation Summary / Donation Info / Anonymous: (Yes/No)
Donation Summary / Donation Info / Amount: Shows the $USD amount of the cryptocurrency donation after it is converted to cash (Less TGB fees)
Donation Summary / Donation Info / Donor Name (Will display as "Anonymous Donor" if Anonymous = Yes)
Donation Summary / Donation Info / Date
Donation Summary / Donation Info / Tender: Will always show as "Other" if it is cryptocurrency for MVP
Donation Summary / Donation Info / Cryptocurrency Amount: Will show the amount of cryptocurrency (not the dollar value, just like stocks)
Donation Summary / Donation Info / Cryptocurrency Ticker: Will show the ticker of the crypto (i.e. BTC, ETH, ZEC etc)
Donation Summary / Donation Info / Cryptocurrency Exchange Rate: Will show the rate in $USD at the time the cryptocurrency is converted to cash (NOT the time that it is donated)
Donation Summary / Donor Information / Donor Name
Donation Summary / Donor Information / Address Line 1
Donation Summary / Donor Information / City
Donation Summary / Donor Information / Zip
Donation Summary / Donor Information / Email
Donation Summary / Donor Information / Country
NB: Each donor will show as a new account for the MVP of the integration, to prevent/address duplicate you will need to do the following:
We are currently working to mitigate duplicated accounts by preloading via First name, Last name and Email fields (if those are submitted in The Giving Block widget i.e. not an anonymous donation) from the NeonCRM first before sending it.
All fields are created for Donation object. Custom field group is created first with following data:
Next step is to create custom fields themselves with following data:
Custom Field #1
Custom Field #2
Custom Field #3
Custom Field #4
Custom Field #5
Developer Notes on Data
Do you address any data synchronization occurrences, including the refresh interval and what data fields are UPDATED in NeonCRM?
We do not have any data synchronization intervals, we send and retrieve data once donation is made.
If you CREATE NeonCRM data, do you list specific data types in the documentation?
We do create data of Account, Donation and Payment data types.
If you RETRIEVE NeonCRM data, do you list specific data types in the documentation?
We do retrieve data of Account, Donation, Payment (and it's Tender types), Campaign, Country and StateProvince data types.
Do you list the specific fields that your integration SENDS to NeonCRM?
Account fields:
Donation fields:
...custom fields described above
Payment fields:
Do you list the specific fields that your integration RETRIEVES from NeonCRM?
For every data type we retrieve, we retrieve the whole object (all fields).
Your client Success Manager will go to
To find out how to discover duplicates, convert and delete accounts, please refer to
Donations currently use the tender type of combined with custom fields for donation objects as listed below.
The Giving Block/NeonCRM Integration will allow you to seamlessly sync cryptocurrency donation information with your Neon CRM, meaning you will no longer have to wait for reports from The Giving Block