Blackbaud Raisers Edge NXT Prospects

Blackbaud Raiser's Edge NXT is a comprehensive cloud-based fundraising and donor management software solution built specifically for nonprofits and the entire social good community. Use the Prospects connector to manage prospects, opportunities, and ratings.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Blackbaud Support
URL	https://www.blackbaud.com/support
Email	skyapi@blackbaud.com

Connector Metadata
Publisher	Blackbaud, Inc.
Website	https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Privacy policy	https://www.blackbaud.com/privacy-shield
Categories	Sales and CRM;Productivity

Raiser's Edge NXT is a comprehensive cloud-based fundraising and donor management software solution built specifically for nonprofits and the entire social good community.

This connector is built on top of Blackbaud's SKY API, and provides operations to help manage prospects and related entities found within The Raiser's Edge NXT, including:

• Prospects
• Opportunities
• Ratings
• and more...

For more information, please view the documentation.

Prerequisites

To use this connector, you must have a Blackbaud ID account with access to one or more Blackbaud environments.

In addition, your organization's administrator must also perform an admin-level action within the system to enable this connector to access your Blackbaud environment. More information about these prerequisites can be found in the initial setup documentation.

How to get credentials?

Your organization's administrator will send you an invitation to the organization's Raiser's Edge NXT environment and configure your user account permissions within the environment. No additional credentials are required to use this connector.

Known issues and limitations

The connector will operate in the context of your user account, and will therefore be subject to your user permissions within the environment.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a constituent rating	Creates a new constituent rating.
Create an opportunity	Creates a new opportunity.
Create an opportunity attachment	Creates a new opportunity attachment.
Create an opportunity custom field	Creates a new opportunity custom field.
Get an opportunity	Returns information about an opportunity. Note: This endpoint returns the status property with a latency of about 10 minutes.
Get constituent prospect status	Returns the current prospect status for a constituent.
List constituent ratings	Returns the list of ratings for a constituent.
List opportunities	Returns a list of opportunities.
List opportunity attachments	Lists the attachments for an opportunity.
List opportunity custom fields	Lists the custom fields for an opportunity.
Update an opportunity	Updates an opportunity.
Update an opportunity attachment	Updates an opportunity attachment.
Update an opportunity custom field	Updates an opportunity custom field.

Create a constituent rating

Operation ID:

CreateConstituentRating

Creates a new constituent rating.

Parameters

Name	Key	Required	Type	Description
body	body	True	dynamic	An object that represents the rating to create.

Returns

Created constituent rating

Body

ConstituentApi.CreatedConstituentRating

Create an opportunity

Operation ID:

CreateOpportunity

Creates a new opportunity.

Parameters

Name	Key	Required	Type	Description
Constituent ID	constituent_id	True	string	The system record ID of the constituent associated with the opportunity.
Purpose	purpose	True	string	The intended use for any money raised as a result of the opportunity.
Name	name	True	string	The name that identifies the opportunity throughout the program, such as in lists or on constituent records. Character limit: 255.
Status	status		string	The status that indicates where the opportunity is in the solicitation process.
Deadline	deadline		date-time	The goal date for the opportunity to result in a gift (ex: '2020-09-18T04:13:56Z').
Ask date	ask_date		date-time	The date when the solicitation was made (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Expected date	expected_date		date-time	The date when the prospect is expected to give in response to the opportunity (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Funded date	funded_date		date-time	The date when the prospect gave in response to the opportunity (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Campaign ID	campaign_id		string	The system record ID of the campaign associated with the opportunity. The campaign sets the overall objectives for raising money.
Fund ID	fund_id		string	The system record ID of the fund associated with the opportunity. The fund designates the specific financial purpose of a gift and identifies the financial account for that gift.
Constituent ID	constituent_id		string	The system record ID of the constituent associated with the fundraiser.
value	value		double	The monetary value.
Inactive?	inactive		boolean	Is the opportunity inactive?

Returns

Created opportunity

Body

OpportunityApi.CreatedOpportunity

Create an opportunity attachment

Operation ID:

CreateOpportunityAttachment

Creates a new opportunity attachment.

Parameters

Name	Key	Required	Type	Description
Opportunity ID	parent_id	True	string	The system record ID of the opportunity associated with the attachment.
Type	type	True	string	The attachment type. Physical attachments are uploaded files such as images, PDFs, or Word documents that are saved locally or on the network. They are stored and managed in the system. Link attachments are links to files such as images, blog posts, or YouTube videos that are online or in a cloud storage account. They are stored and managed externally.
Name	name		string	The name of the attachment. Character limit: 150.
Date	date		date-time	The date of the attachment (ex: '2020-09-18T04:13:56Z'). This field defaults to the current date and time if not supplied.
URL	url		string	The URL for the attachment. This is required for link attachments and not applicable for physical attachments.
File name	file_name		string	The name of the file. Character limit: 36. For physical attachments only.
File ID	file_id		string	The identifier of the file. Character limit: 36. For physical attachments only.
Thumbnail ID	thumbnail_id		string	The identifier of the thumbnail. Character limit: 36. For physical attachments only.
Tags	tags		array of string	The tags associated with the attachment.

Returns

Created opportunity attachment

Body

OpportunityApi.CreatedOpportunityAttachment

Create an opportunity custom field

Operation ID:

CreateOpportunityCustomField

Creates a new opportunity custom field.

Parameters

Name	Key	Required	Type	Description
body	body	True	dynamic	An object that represents the custom field to create.

Returns

Created opportunity attachment

Body

OpportunityApi.CreatedOpportunityCustomField

Get an opportunity

Operation ID:

GetOpportunity

Returns information about an opportunity. Note: This endpoint returns the status property with a latency of about 10 minutes.

Parameters

Name	Key	Required	Type	Description
Opportunity ID	opportunity_id	True	string	The system record ID of the opportunity to get.

Returns

Opportunity

Body

OpportunityApi.OpportunityRead

Get constituent prospect status

Operation ID:

GetConstituentProspectStatus

Returns the current prospect status for a constituent.

Parameters

Name	Key	Required	Type	Description
Constituent ID	constituent_id	True	string	The system record ID of the constituent for whom the prospect status is to be retrieved.

Returns

Prospect status

Body

ConstituentApi.ProspectStatusRead

List constituent ratings

Operation ID:

ListConstituentRatings

Returns the list of ratings for a constituent.

Parameters

Name	Key	Required	Type	Description
Constituent ID	constituent_id	True	string	The system record ID of the constituent
Include inactive?	include_inactive		boolean	Include inactive ratings?
Only most recent?	most_recent_only		boolean	Include only the most recent ratings?

Returns

Ratings

Body

ConstituentApi.ApiCollectionOfRatingRead

List opportunities

Operation ID:

ListOpportunities

Returns a list of opportunities.

Parameters

Name	Key	Required	Type	Description
List	list_id		string	Defines a list identifier used to filter the set of opportunities to those included in the specified list. If this value is set, other specified filters will be ignored.
Constituent ID	constituent_id		string	Represents a comma-separated list of constituent system record IDs to filter the results. For example, "280,1232" returns only opportunities from constituent 280 or constituent 1232.
Limit	limit		integer	Represents the number of records to return. The default is 500. The maximum is 5000.
Offset	offset		integer	Represents the number of records to skip. For use with pagination.
Include inactive?	include_inactive		boolean	Include inactive opportunities?
Added on or after	date_added		date-time	Filter the results to opportunities created on or after the specified date (ex: '2020-09-18T04:13:56Z').
Modified on or after	last_modified		date-time	Filter the results to opportunities modified on or after the specified date (ex: '2020-09-18T04:13:56Z').

Returns

Opportunities

Body

OpportunityApi.ApiCollectionOfOpportunityRead

List opportunity attachments

Operation ID:

ListOpportunityAttachments

Lists the attachments for an opportunity.

Parameters

Name	Key	Required	Type	Description
Opportunity ID	opportunity_id	True	string	The system record ID of the opportunity.

Returns

Attachments

Body

OpportunityApi.ApiCollectionOfOpportunityAttachmentRead

List opportunity custom fields

Operation ID:

ListOpportunityCustomFields

Lists the custom fields for an opportunity.

Parameters

Name	Key	Required	Type	Description
Opportunity ID	opportunity_id	True	string	The system record ID of the opportunity.

Returns

Custom fields

Body

OpportunityApi.ApiCollectionOfOpportunityCustomFieldRead

Update an opportunity

Operation ID:

EditOpportunity

Updates an opportunity.

Parameters

Name	Key	Required	Type	Description
Opportunity ID	opportunity_id	True	string	The system record ID of the opportunity to update.
Purpose	purpose		string	The intended use for any money raised as a result of the opportunity.
Name	name		string	The name that identifies the opportunity throughout the program, such as in lists or on constituent records. Character limit: 255.
Status	status		string	The status that indicates where the opportunity is in the solicitation process.
Deadline	deadline		date-time	The goal date for the opportunity to result in a gift (ex: '2020-09-18T04:13:56Z').
Ask date	ask_date		date-time	The date when the solicitation was made (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Expected date	expected_date		date-time	The date when the prospect is expected to give in response to the opportunity (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Funded date	funded_date		date-time	The date when the prospect gave in response to the opportunity (ex: '2020-09-18T04:13:56Z').
value	value		double	The monetary value.
Campaign ID	campaign_id		string	The system record ID of the campaign associated with the opportunity. The campaign sets the overall objectives for raising money.
Fund ID	fund_id		string	The system record ID of the fund associated with the opportunity. The fund designates the specific financial purpose of a gift and identifies the financial account for that gift.
Constituent ID	constituent_id		string	The system record ID of the constituent associated with the fundraiser.
value	value		double	The monetary value.
Inactive?	inactive		boolean	Is the opportunity inactive?

Update an opportunity attachment

Operation ID:

EditOpportunityAttachment

Updates an opportunity attachment.

Parameters

Name	Key	Required	Type	Description
Attachment ID	attachment_id	True	string	The system record ID of the attachment to update.
Name	name		string	The name of the attachment. Character limit: 150.
Date	date		date-time	The date of the attachment (ex: '2020-09-18T04:13:56Z').
URL	url		string	The URL for the attachment. This is required for link attachments and not applicable for physical attachments.
Tags	tags		array of string	The tags associated with the attachment.

Update an opportunity custom field

Operation ID:

EditOpportunityCustomField

Updates an opportunity custom field.

Parameters

Name	Key	Required	Type	Description
Custom field ID	custom_field_id	True	string	The system record ID of the custom field to update.
body	body	True	dynamic	An object that represents the properties of the custom field to update.

Definitions

ConstituentApi.ApiCollectionOfRatingRead

Ratings

Name	Path	Type	Description
Count	count	integer	The number of items available for retrieval into the collection after applying any request parameters. The limit and offset parameters do not affect the count, but to facilitate paging, they may affect the number of items in the value result set.
value	value	array of ConstituentApi.RatingRead	The set of items included in the response. This may be a subset of the items in the collection.

ConstituentApi.CreatedConstituentRating

Created constituent rating

Name	Path	Type	Description
ID	id	string	The ID of the newly created constituent rating.

ConstituentApi.ProspectStatusRead

Prospect status

Name	Path	Type	Description
Status	status	string	The constituent's current prospect status.
Days elapsed	days_elapsed	integer	Total number of days in the current prospect status based on the start date.
Start date	start	date-time	The start date of the prospect status.
Comments	comments	string	The comments on the prospect status.

ConstituentApi.RatingRead

Rating

Name	Path	Type	Description
ID	id	string	The system record ID of the rating.
Constituent ID	constituent_id	string	The system record ID of the constituent associated with the rating.
Source	source	string	The source of the new rating.
Category	category	string	The category of the rating.
Date	date	date-time	The date of the rating.
Description	value		The value of the rating.
Comments	comment	string	A comment about the rating.
Inactive?	inactive	boolean	Is the rating inactive?
Type	type	string	This computed field indicates the type of data that the rating represents based on the category property.

OpportunityApi.ApiCollectionOfOpportunityAttachmentRead

Attachments

Name	Path	Type	Description
Count	count	integer	The number of items available for retrieval into the collection after applying any request parameters. The limit and offset parameters do not affect the count, but to facilitate paging, they may affect the number of items in the value result set.
value	value	array of OpportunityApi.OpportunityAttachmentRead	The set of items included in the response. This may be a subset of the items in the collection.

OpportunityApi.ApiCollectionOfOpportunityCustomFieldRead

Custom fields

Name	Path	Type	Description
Count	count	integer	The number of items available for retrieval into the collection after applying any request parameters. The limit and offset parameters do not affect the count, but to facilitate paging, they may affect the number of items in the value result set.
value	value	array of OpportunityApi.OpportunityCustomFieldRead	The set of items included in the response. This may be a subset of the items in the collection.

OpportunityApi.ApiCollectionOfOpportunityRead

Opportunities

Name	Path	Type	Description
Count	count	integer	The number of items available for retrieval into the collection after applying any request parameters. The limit and offset parameters do not affect the count, but to facilitate paging, they may affect the number of items in the value result set.
value	value	array of OpportunityApi.OpportunityRead	The set of items included in the response. This may be a subset of the items in the collection.

OpportunityApi.CreatedOpportunity

Created opportunity

Name	Path	Type	Description
ID	id	string	The ID of the newly created opportunity.

OpportunityApi.CreatedOpportunityAttachment

Created opportunity attachment

Name	Path	Type	Description
ID	id	string	The ID of the newly created opportunity attachment.

OpportunityApi.CreatedOpportunityCustomField

Created opportunity attachment

Name	Path	Type	Description
ID	id	string	The ID of the newly created opportunity attachment.

OpportunityApi.Fundraiser

Fundraiser

Name	Path	Type	Description
Constituent ID	constituent_id	string	The system record ID of the constituent associated with the fundraiser.
value	credit_amount.value	double	The monetary value.

OpportunityApi.OpportunityAttachmentRead

Attachment

Name	Path	Type	Description
ID	id	string	The system record ID of the attachment.
Opportunity ID	parent_id	string	The system record ID of the opportunity associated with the attachment.
Type	type	string	The attachment type. Physical attachments are uploaded files such as images, PDFs, or Word documents that are saved locally or on the network. They are stored and managed in the system. Link attachments are links to files such as images, blog posts, or YouTube videos that are online or in a cloud storage account. They are stored and managed externally.
Name	name	string	The name of the attachment. Character limit: 150.
Date	date	date-time	The date of the attachment.
URL	url	string	The URL for the attachment. This is required for link attachments and not applicable for physical attachments.
File name	file_name	string	The name of the file. Character limit: 36. For physical attachments only.
File ID	file_id	string	The identifier of the file. Character limit: 36. For physical attachments only.
Thumbnail ID	thumbnail_id	string	The identifier of the thumbnail. Character limit: 36. For physical attachments only.
Thumbnail URL	thumbnail_url	string	The URL for a thumbnail. For physical attachments that are images only. Contains a time-bound signature that limits access to 60 minutes.
Content type	content_type	string	The content type. For physical attachments only.
File size	file_size	integer	The file size in bytes. For physical attachments only.
Tags	tags	array of string	The tags associated with the attachment.

OpportunityApi.OpportunityCustomFieldRead

Custom field

Name	Path	Type	Description
ID	id	string	The system record ID of the custom field.
Opportunity ID	parent_id	string	The system record ID of the opportunity associated with the custom field.
Category	category	string	The custom field category.
Type	type	string	The type of data that the custom field represents.
Value	value		The value of the custom field.
Text value	text_value	string	The text value of the custom field.
Number value	number_value	integer	The numeric value of the custom field.
Date value	date_value	date	The date value of the custom field.
Currency value	currency_value	double	The currency value of the custom field.
Boolean value	boolean_value	boolean	The boolean value of the custom field.
Table entry value	codetableentry_value	string	The table entry value of the custom field.
Constituent ID value	constituentid_value	string	The constituent ID value of the custom field.
day	fuzzydate_value.d	integer	The day in the fuzzy date.
month	fuzzydate_value.m	integer	The month in the fuzzy date.
year	fuzzydate_value.y	integer	The year in the fuzzy date.
Date	date	date	The date on the custom field.
Comment	comment	string	The comment on the custom field. Character limit: 50.
Date added	date_added	date-time	The date when the custom field was created.
Date modified	date_modified	date-time	The date when the custom field was last modified.

OpportunityApi.OpportunityRead

Opportunity

Name	Path	Type	Description
ID	id	string	The system record ID of the opportunity.
Constituent ID	constituent_id	string	The system record ID of the constituent associated with the opportunity.
Purpose	purpose	string	The intended use for any money raised as a result of the opportunity.
Name	name	string	The name that identifies the opportunity throughout the program, such as in lists or on constituent records. Character limit: 255.
Status	status	string	The status that indicates where the opportunity is in the solicitation process.
Deadline	deadline	date-time	The goal date for the opportunity to result in a gift.
Ask date	ask_date	date-time	The date when the solicitation was made.
value	ask_amount.value	double	The monetary value.
Expected date	expected_date	date-time	The date when the prospect is expected to give in response to the opportunity.
value	expected_amount.value	double	The monetary value.
Funded date	funded_date	date-time	The date when the prospect gave in response to the opportunity.
value	funded_amount.value	double	The monetary value.
Campaign ID	campaign_id	string	The system record ID of the campaign associated with the opportunity. The campaign sets the overall objectives for raising money.
Fund ID	fund_id	string	The system record ID of the fund associated with the opportunity. The fund designates the specific financial purpose of a gift and identifies the financial account for that gift.
Fundraiser(s)	fundraisers	array of OpportunityApi.Fundraiser	The set of system record IDs for the fundraisers assigned to the opportunity.
Inactive?	inactive	boolean	Is the opportunity inactive?
linked_gifts	linked_gifts	array of string	The system record IDs of the gifts related to the opportunity.
Date added	date_added	date-time	The date when the opportunity was created.
Date modified	date_modified	date-time	The date when the opportunity was last modified.