Home Nodes Blackbaud Raiser's Edge NXT

Blackbaud Raiser's Edge NXT

Integrate with Blackbaud Raiser's Edge NXT directly from your workflows to manage constituents, gifts, and related CRM data.. Many samples have been provided for you, via Node Samples, to easily set up and execute common operations.

Revision History

1.0.0.0 Initial release

Properties

Connection

Type: Connection Input
Connection profile containing OAuth credentials, tokens, and subscription key.

ClientId
Type: String
Your Blackbaud Application OAuth Client ID.

ClientSecret
Type: Secret
Your Blackbaud Application OAuth Client Secret.

AccessToken
Type: Secret
Automatically-managed OAuth Access Token used to authenticate API requests.

RefreshToken
Type: Secret
Automatically-managed OAuth Refresh Token used to renew Access Tokens.

ApiSubscriptionKey
Type: Secret
Your Blackbaud SKY API Subscription Key. Leave blank to use Flowgear’s built-in key.

OperationId

Type: String Input
A unique identifier that ties this request to a specific sample.

Name

Type: String Input
The friendly name of the current sample.

Request

Type: JSON Input
This is where you provide the JSON body for any POST, PUT, or PATCH operations.
An example payload may be populated when you select a sample that requires a request body.

Response

Type: JSON Output
After the Node executes, this will contain the JSON response received from the Blackbaud API.

Custom Properties

This Node supports Custom Input Properties and the appropriate properties will be added to the Node when a Node Sample is selected. These Properties are resolved into parameters in the URL that is generated for the request. For example, if the operation will query a customer record, the definition document may specify the URL template as /constituents/{constituentId}. In this case, a Custom Property called constituentId will be added to the Node when a "Constituent (Get)" Node Sample is selected.

Configuring the Node

Before you run your workflow, you must create and test a Connection for Raiser's Edge NXT:

1. Create a Blackbaud Application

If you already have an existing Blackbaud application, skip to Step 1.4.

  1. Sign in at the Blackbaud Developer Portal.
  2. Navigate to → My Applications → + New application.
  3. Fill in the required details of your application as desired, and click Save.
  4. On your application's dashboard, you should see Client ID and Client Secret. You will need these for later steps.
  5. Under the Redirect URIs section, add the following:
  6. Under the Scopes section, click ✎ Edit and under the Raiser's Edge NXT section, select the following:
    • Read
    • Write
    • Delete
    • Subscribe to events

2. Create the Connection

  1. In the Flowgear Console, click Connections.
  2. Add a new Connection of type Blackbaud Raiser’s Edge NXT.
  3. Enter the Client ID and Client Secret from your Blackbaud application from Step 1.
  4. Optionally set ApiSubscriptionKey if you have one, or leave blank to use our built-in key.
  5. Click Connect your Account.
  6. You will be redirected to a Blackbaud login page using its authorisation URL. Sign in and grant the application access.
  7. Save your Connection.

After you authorise the application, Blackbaud will redirect you back to Flowgear with an authorisation code. The platform automatically completes the OAuth 2.0 handshake by exchanging the code for an Access Token and Refresh Token, which are securely stored within the Connection.

3. Test your Connection

  1. Navigate to your new Raiser's Edge NXT Connection.
  2. Click Test.
  3. Flowgear will attempt a test API call to a generic Blackbaud endpoint to ensure your credentials are valid.

If the test is successful (✓), your credentials are valid.
If it fails (✗), the test will return an error message, and you may need to re-authorise the Connection. If this problem persists, please contact support for assistance.

Remarks

  • If your Access Token expires, the node will automatically call Blackbaud’s token endpoint to refresh it.