Troubleshooting Raiser's Edge NXT Integration Connection Issues
Common connection problems and solutions
Integration connections between GiveCampus and Raiser's Edge NXT can sometimes fail due to permission changes or expired tokens.
Why do NXT integrations lose connection?
Most common causes:
1. Account permissions changed - The user who set up the integration no longer has proper NXT permissions 2. Token expiration - BlackBaud tokens expire and need renewal 3. Password changes - User password changes can affect integration authentication 4. Role modifications - Changes to user roles in RE NXT can break the connection
How to fix connection issues
Step 1: Check user permissions
1. Verify the original integration user still has an active NXT account 2. Confirm they have the necessary permissions for: - Gift import/export - Constituent management - API access 3. Check if their role assignments have changed
Step 2: Reconnect the integration
1. Navigate to the School Dashboard > Integrations > Blackbaud RE NXT tab.
3. Disconnect the current NXT connection
4. Connect the integration using an account with proper permissions.
Error messages you might see
- "BlackBaud connection needs to be reconnected"
- "Token expired"
- "Authentication failed"
- "Insufficient permissions"
Prevention tips
Best practices to avoid connection issues:
1. Use a dedicated service account - Set up integration with an account specifically for this purpose 2. Assign stable permissions - Ensure the integration user has consistent, long-term access rights 3. Regular monitoring - Check integration status periodically 4. Document the setup - Keep records of which account is used and what permissions are needed
Common variations of this question:
- "Why is my NXT integration not working?"
- "How do I fix BlackBaud connection errors?"
- "My RE NXT integration stopped working, what should I do?"
- "Token expired error in GiveCampus integration"
- "Permission errors with Raiser's Edge connection"
- "How to reconnect BlackBaud integration?"
When to contact support
Contact GiveCampus support if:
- You've verified permissions and the connection still fails
- You're unsure which account was used for the original setup
- Error messages persist after reconnection attempts
- You need help identifying the specific permissions required
How to reconnect NXT integration with a new user account
If the original user who set up the integration is no longer available, you can transfer the connection to a new user account.
Steps to reconnect with a new user
1. Disconnect the existing integration
- Go to School Dashboard > Data Import > Data Sources > BlackBaud NXT
- Scroll to the bottom of the page
- Click the "Disconnect" button
2. Set up the new connection
- Follow the standard NXT integration setup instructions
- Ensure the new user has proper RE NXT permissions
- Test the connection after setup
Common scenarios requiring reconnection
- Original integration user left the organization
- User account permissions were revoked
- Need to transfer integration ownership to a different team member
Common variations of this question
- How do I change the NXT integration user?
- Can I transfer NXT integration to a different account?
- Original NXT user no longer works here, how to reconnect?
- Steps to disconnect and reconnect NXT integration
- How to switch NXT integration to new user account
How to Reconnect Your NXT Integration
Step-by-step reconnection process
If you've confirmed that permission issues are causing your integration problems, follow these steps:
1. Navigate to your integration dashboard: https://www.givecampus.com/schools/[YourSchoolName]/dashboard/data_sources/blackbaud_api
2. Have a user with proper NXT permissions perform the reconnection
3. Follow the authentication prompts to reestablish the connection
Required NXT permissions for integration users
The user reconnecting the integration must have:
- Active Blackbaud account access
- Appropriate data access permissions in RE NXT
- API access permissions (if using custom integrations)
Common Variations of This Question
- "NXT integration permission error"
- "Blackbaud connection failing"
- "Integration user lost access to NXT"
- "How to reconnect NXT integration"
- "RE NXT authentication problems"
Gifts to Review Table Issues
When Gifts Aren't Leaving GiveCampus
If gifts are not appearing in Raiser's Edge NXT at all (no gifts being exported from GiveCampus), the issue is often that gifts are stuck in your "Gifts to Review" table.
Step 1: Check your Gifts to Review table
1. Log into your GiveCampus account
2. Navigate to Manage Gifts tab
3. Look for the "Gifts to Review" section
4. Check if your missing gifts appear in this table
Step 2: Review gift status and notes
Each gift in the Gifts to Review table will have notes indicating:
- Missing required data fields
- Formatting issues
- Mapping problems
- Other blocking issues
Step 3: Resolve data issues
Common data issues that prevent export:
- Missing or invalid constituent IDs
- Incorrect appeal codes
- Missing required custom fields
- Invalid designation mappings
Step 4: Process gifts after fixes
Once you've resolved the data issues:
1. Update the gift records in GiveCampus
2. The gifts should automatically move from "Gifts to Review" to your regular export queue
3. They will then export to Raiser's Edge NXT on the next sync
Event Payment Classification Issues
Event Payments Mapping as "One Time Gift" Instead of "Other"
Event registration payments may appear as "One Time Gift" instead of "Other" in your Raiser's Edge NXT batch, making it difficult to distinguish them from regular donations.
How event payment mapping works:
- Fair Market Value (FMV) portion: Maps to "Other" gift type
- Gift portion (non-FMV): Maps to "One Time Gift"
Important notes:
- GiveCampus cannot change this mapping behavior
- The mapping is determined by how you configure FMV vs. gift portions in your event setup
- If you want to completely separate event payments from gifts, set full ticket prices as FMV
Troubleshooting No Exports Since Specific Date
If your integration stopped working completely after a certain date:
Step 1: Verify integration connection
1. Check the integration settings in the School Dashboard -> Data Import -> Data Sources
2. Look for any error messages or connection warnings
3. Verify the integration user's BlackBaud account is still active
Step 2: Review all pending gifts
1. Check your Gifts to Review table for stuck transactions
2. Verify recent gifts aren't waiting for manual review
3. Look for any bulk data issues that might block all exports
Common variations of this question
- Gifts not exporting to Raiser's Edge
- March gifts missing from RE NXT
- Event payments showing as donations
- Gifts stuck in review table
- Integration stopped working completely
- Event registrations mapping incorrectly
- Can't tell difference between gifts and events in RE
- FMV mapping to Other gift type
- Gift portion vs fair market value
- Gifts to Review table blocking exports
- Missing required data preventing export
- Integration connection lost after date
- No gifts leaving GiveCampus
- Event payments need to be Other type
- How to separate event payments from gifts
Comments
0 comments
Please sign in to leave a comment.