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