Share via


Blackbaud Raisers Edge NXT Gifts

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 Gifts connector to manage gifts.

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 gifts and related entities found within The Raiser's Edge NXT, including:

  • Gifts and constituent giving summaries
  • Gift batches
  • Receipts
  • Acknowledgements
  • 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

Add a gift to batch

Add a gift to the specified gift batch.

Create a constituent tax declaration

Creates a new Gift Aid tax declaration for a constituent.

Create a gift

Creates a new gift.

Create a gift attachment

Creates a new gift attachment.

Create a gift batch

Creates a new gift batch.

Create a gift custom field

Creates a new gift custom field.

Create a gift note

Creates a new gift note.

Create a gift tribute

Creates a new gift tribute.

Get a gift

Returns information about a gift.

Get a gift by lookup ID

Returns a gift's system record ID from the specified lookup ID.

Get constituent first gift

Returns the first gift for a constituent.

Get constituent greatest gift

Returns the greatest gift for a constituent.

Get constituent latest gift

Returns the latest gift for a constituent.

Get constituent lifetime giving

Returns the lifetime giving summary for a constituent.

List constituent tax declarations

Lists the Gift Aid tax declarations for a constituent (only applicable for UK versions).

List gift attachments

Lists the attachments for a gift.

List gift batches

List the gift batches.

List gift custom fields

Lists the custom fields for a gift.

List gift notes

Lists the notes for a gift.

List gift tribute acknowledgees

List the acknowledgees for a gift tribute.

List gift tributes

Lists the tributes for a gift.

List gifts

Returns a list of gifts.

Update a constituent tax declaration

Updates a constituent tax declaration.

Update a gift attachment

Updates a gift attachment.

Update a gift custom field

Updates a gift custom field.

Update a gift note

Updates a gift note.

Update a gift tribute

Updates a gift tribute.

Update a gift tribute acknowledgee

Updates a gift tribute acknowledgee.

Update gift acknowledgement details

Updates the acknowledgement details for a gift.

Update gift receipt details

Updates the receipt details for a gift.

Add a gift to batch

Add a gift to the specified gift batch.

Parameters

Name Key Required Type Description
Batch
batch_id True string

The batch to which the gift will be added.

Constituent ID
constituent_id True string

The system record ID of the constituent associated with the gift.

Amount
value True double

The monetary amount of the gift.

Date
date True date

The gift date (ex: '2020-09-18').

Type
type True string

The gift type.

campaign ID
campaign_id string

The system record ID of the campaign associated with the gift split.

fund ID
fund_id True string

The system record ID of the fund associated with the gift split.

appeal ID
appeal_id string

The system record ID of the appeal associated with the gift split.

package ID
package_id string

The system record ID of the package associated with the gift split.

amount
value True double

The monetary amount of the gift split.

Payment method
payment_method True string

The payment method.

Check number
check_number string

The check number (only applicable when payment method is "PersonalCheck").

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Reference
reference string

The payment reference (only applicable when payment method is "Other").

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Is anonymous?
is_anonymous boolean

Is the gift anonymous? If no value is provided, the default anonymity of the donor will be used.

Subtype
subtype string

The subtype of the gift.

Comment
reference string

Notes to track special details about a gift such as the motivation behind it or a detailed description of a gift-in-kind.

Lookup ID
lookup_id string

The user-defined identifier for the gift.

Use fundraiser credits?
default_fundraiser_credits boolean

Use the default fundraiser credits?

Use soft credits?
default_soft_credits boolean

Use the default soft credits?

Constituency
constituency string

The constituency of the gift.

Post status
post_status string

The post status of the gift.

Post date
post_date date

The date the gift was posted (ex: '2020-09-18').

Receipt status
status True string

The receipt status of the gift.

Receipt amount
value True double

The monetary amount of the receipt for the gift.

Receipt date
date date

The date that the gift was receipted (ex: '2020-09-18').

Returns

Contains a collection of batch gift error records and the batch gifts that the operation added

Create a constituent tax declaration

Creates a new Gift Aid tax declaration for a constituent.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True integer

The system record ID of the constituent.

Declaration starts
declaration_starts True date-time

The date the tax declaration starts (ex: '2020-09-18T04:13:56Z').

Declaration ends
declaration_ends date-time

The date the tax declaration ends (ex: '2020-09-18T04:13:56Z').

Declaration made
declaration_made date-time

The date the tax declaration was made (ex: '2020-09-18T04:13:56Z').

Indicator
declaration_indicator string

The declaration indicator.

Source
declaration_source string

The declaration source.

Confirmation sent
confirmation_sent date-time

The date the confirmation was sent (ex: '2020-09-18T04:13:56Z').

Confirmation returned
confirmation_returned date-time

The date the confirmation was returned (ex: '2020-09-18T04:13:56Z').

Pays tax
constituent_pays_tax string

Indicates whether the constituent pays tax.

Status
tax_payer_status string

The tax payer status.

Comments
tax_notes string

Comments for the tax declaration.

Sequence
sequence integer

The numeric sequence associated with the tax declaration.

Returns

Created tax declaration

Create a gift

Creates a new gift.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True string

The system record ID of the constituent associated with the gift.

Amount
value True double

The monetary amount of the gift.

Date
date True date

The gift date (ex: '2020-09-18').

Type
type True string

The gift type.

campaign ID
campaign_id string

The system record ID of the campaign associated with the gift split.

fund ID
fund_id True string

The system record ID of the fund associated with the gift split.

appeal ID
appeal_id string

The system record ID of the appeal associated with the gift split.

package ID
package_id string

The system record ID of the package associated with the gift split.

amount
value True double

The monetary amount of the gift split.

Payment method
payment_method True string

The payment method.

Check number
check_number string

The check number (only applicable when payment method is "PersonalCheck").

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Reference
reference string

The payment reference (only applicable when payment method is "Other").

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Is anonymous?
is_anonymous boolean

Is the gift anonymous? If no value is provided, the default anonymity of the donor will be used.

Subtype
subtype string

The subtype of the gift.

Comment
reference string

Notes to track special details about a gift such as the motivation behind it or a detailed description of a gift-in-kind.

Lookup ID
lookup_id string

The user-defined identifier for the gift.

Use fundraiser credits?
default_fundraiser_credits boolean

Use the default fundraiser credits?

Use soft credits?
default_soft_credits boolean

Use the default soft credits?

Constituency
constituency string

The constituency of the gift.

Batch prefix
batch_prefix string

The prefix to use for batch gifts. This must include at least one letter, and is required when 'Batch number' has a value.

Batch number
batch_number string

The batch number. Character limit: 50 (including the batch prefix).

Post status
post_status string

The post status of the gift.

Post date
post_date date

The date the gift was posted (ex: '2020-09-18').

Receipt status
status True string

The receipt status of the gift.

Receipt amount
value True double

The monetary amount of the receipt for the gift.

Receipt date
date date

The date that the gift was receipted (ex: '2020-09-18').

Returns

Created gift

Create a gift attachment

Creates a new gift attachment.

Parameters

Name Key Required Type Description
Gift ID
parent_id True string

The system record ID of the gift 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 gift attachment

Create a gift batch

Creates a new gift batch.

Parameters

Name Key Required Type Description
Description
batch_description string

The description of the batch.

Expected number
expected_number integer

The number of gifts expected in the batch.

Expected total
expected_batch_total double

The total value of gifts in the batch.

Batch number
batch_number string

The unique identifier specific to the batch.

Returns

Created gift batch

Create a gift custom field

Creates a new gift custom field.

Parameters

Name Key Required Type Description
body
body True dynamic

An object that represents the custom field to create.

Returns

Created gift custom field

Create a gift note

Creates a new gift note.

Parameters

Name Key Required Type Description
Gift ID
gift_id True integer

The system record ID of the gift associated with the note.

Type
note_type_id True integer

The note type.

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Summary
summary string

The note summary. Character limit: 255.

Note
text string

The note text.

Author
author string

The note author. Character limit: 50.

Returns

Created note

Create a gift tribute

Creates a new gift tribute.

Parameters

Name Key Required Type Description
Gift ID
gift_id True integer

The system record ID of the gift associated with the gift tribute.

Tribute ID
tribute_id True integer

The system record ID of the tribute associated with the gift tribute.

Returns

Created gift tribute

Get a gift

Returns information about a gift.

Parameters

Name Key Required Type Description
Gift ID
gift_id True string

The system record ID of the gift to get.

Returns

Gift

Get a gift by lookup ID

Returns a gift's system record ID from the specified lookup ID.

Parameters

Name Key Required Type Description
Lookup ID
giftlookupid True string

The gift lookup ID.

Returns

Gift ID map

Get constituent first gift

Returns the first gift for a constituent.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True string

The system record ID of the constituent.

Returns

Giving summary

Get constituent greatest gift

Returns the greatest gift for a constituent.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True string

The system record ID of the constituent.

Returns

Giving summary

Get constituent latest gift

Returns the latest gift for a constituent.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True string

The system record ID of the constituent.

Returns

Giving summary

Get constituent lifetime giving

Returns the lifetime giving summary for a constituent.

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True string

The system record ID of the constituent.

Returns

Lifetime giving

List constituent tax declarations

Lists the Gift Aid tax declarations for a constituent (only applicable for UK versions).

Parameters

Name Key Required Type Description
Constituent ID
constituent_id True integer

The system record ID of the constituent.

Limit
limit integer

Represents the number of records to return. The default is 500. There is no maximum.

Offset
offset integer

Represents the number of records to skip. For use with pagination.

Returns

Tax declarations

List gift attachments

Lists the attachments for a gift.

Parameters

Name Key Required Type Description
Gift ID
gift_id True string

The system record ID of the gift.

Returns

Attachments

List gift batches

List the gift batches.

Parameters

Name Key Required Type Description
Batch number
batch_number string

Represents a filter for results that match the specified number.

Approved?
approved boolean

Represents a filter for the status of the gift batch.

Has exceptions?
has_exceptions boolean

Represents a filter for whether the gift batch contains exceptions.

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.

Search text
search_text string

Represents a filter for text included in the batch description or batch number fields.

Created by
created_by string

Represents a filter for gift batches created by the specified user.

Returns

Gift batches

List gift custom fields

Lists the custom fields for a gift.

Parameters

Name Key Required Type Description
Gift ID
gift_id True string

The system record ID of the gift.

Returns

Custom fields

List gift notes

Lists the notes for a gift.

Parameters

Name Key Required Type Description
Gift ID
gift_id True integer

The system record ID of the giftt.

Limit
limit integer

Represents the number of records to return.

Offset
offset integer

Represents the number of records to skip. For use with pagination.

Returns

Gift notes

List gift tribute acknowledgees

List the acknowledgees for a gift tribute.

Parameters

Name Key Required Type Description
Gift tribute ID
gift_tribute_id True integer

The system record ID of the gift tribute.

Returns

Gift tribute acknowledgees

List gift tributes

Lists the tributes for a gift.

Parameters

Name Key Required Type Description
Gift ID
gift_id True integer

The system record ID of the gift.

Returns

Gift tributes

List gifts

Returns a list of gifts.

Parameters

Name Key Required Type Description
List
list_id string

Defines a list identifier used to filter the set of gifts to those included in the specified list. If this value is set, other specified filters will be ignored.

Type
gift_type string

Represents a comma-separated list of gift types to filter the results. For example, "MatchingGiftPledge,RecurringGift" returns only gifts of type MatchingGiftPledge or RecurringGift.

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 gifts from constituent 280 or constituent 1232.

Campaign ID
campaign_id string

Represents a comma-separated list of campaign system record IDs to filter the results. For example, "506,918" returns only gifts to campaign 506 or campaign 918.

Fund ID
fund_id string

Represents a comma-separated list of fund system record IDs to filter the results. For example, "506,918" returns only gifts to fund 506 or fund 918.

Appeal ID
appeal_id string

Represents a comma-separated list of appeal system record IDs to filter the results. For example, "506,918" returns only gifts to appeal 506 or appeal 918.

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.

Start gift date
start_gift_date date-time

Represents a filter for gifts with a gift date on or after the specified date (ex: '2020-09-18T04:13:56Z').

End gift date
end_gift_date date-time

Represents a filter for gifts with a gift date on or before the specified date (ex: '2020-09-18T04:13:56Z').

Start gift amount
start_gift_amount double

Represents a filter for gifts with an amount greater than or equal to the specified amount.

End gift amount
end_gift_amount double

Represents a filter for gifts with an amount less than or equal to the specified amount.

Post status
post_status string

Represents a comma-separated list of gift post statuses to filter the results. For example, "DoNotPost,Posted" returns only gifts that are marked as DoNotPost or Posted.

Receipt status
receipt_status string

Represents a comma-separated list of gift receipt statuses to filter the results. For example, "DoNotReceipt,Receipted" returns only gifts that are marked as DoNotReceipt or Receipted.

Acknowledgement status
acknowledgement_status string

Represents a comma-separated list of gift acknowledgement statuses to filter the results. For example, "DoNotAcknowledge,Acknowledged" returns only gifts that are marked as DoNotAcknowledge or Acknowledged.

Sorted by
sort string

Represents a list of fields to sort the results by. Results are in ascending order by default, and a '-' sign denotes descending order. For example, "date_added,-date" sorts gifts by the "date_added" field in ascending order and then by the "gift date" field in descending order. If only the date_modified field or only the date_added field is provided, then this adds the sort_token parameter to the next_link URL to ensure that gifts are stably sorted.

Added on or after
date_added date-time

Filter the results to gifts 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 gifts modified on or after the specified date (ex: '2020-09-18T04:13:56Z').

Returns

Gifts

Update a constituent tax declaration

Updates a constituent tax declaration.

Parameters

Name Key Required Type Description
Tax declaration ID
tax_declaration_id True integer

The system record ID of the tax declaration to update.

Declaration starts
declaration_starts date-time

The date the tax declaration starts (ex: '2020-09-18T04:13:56Z').

Declaration ends
declaration_ends date-time

The date the tax declaration ends (ex: '2020-09-18T04:13:56Z').

Declaration made
declaration_made date-time

The date the tax declaration was made (ex: '2020-09-18T04:13:56Z').

Indicator
declaration_indicator string

The declaration indicator.

Source
declaration_source string

The declaration source.

Confirmation sent
confirmation_sent date-time

The date the confirmation was sent (ex: '2020-09-18T04:13:56Z').

Confirmation returned
confirmation_returned date-time

The date the confirmation was returned (ex: '2020-09-18T04:13:56Z').

Pays tax
constituent_pays_tax string

Indicates whether the constituent pays tax.

Status
tax_payer_status string

The tax payer status.

Comments
tax_notes string

Comments for the tax declaration.

Sequence
sequence integer

The numeric sequence associated with the tax declaration.

Update a gift attachment

Updates a gift 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 a gift custom field

Updates a gift 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.

Update a gift note

Updates a gift note.

Parameters

Name Key Required Type Description
Note ID
id True integer

The system record ID of the note to update.

Type
note_type_id integer

The note type.

day
d integer

The day in the fuzzy date.

month
m integer

The month in the fuzzy date.

year
y integer

The year in the fuzzy date.

Summary
summary string

The note summary. Character limit: 255.

Note
text string

The note text.

Author
author string

The note author. Character limit: 50.

Update a gift tribute

Updates a gift tribute.

Parameters

Name Key Required Type Description
Gift tribute ID
gift_tribute_id True integer

The system record ID of the gift tribute to update.

Tribute type
tribute_type integer

The tribute type.

Acknowledge status
acknowledge string

The gift tribute acknowledge status.

Update a gift tribute acknowledgee

Updates a gift tribute acknowledgee.

Parameters

Name Key Required Type Description
Gift tribute acknowledgee ID
gift_tribute_acknowledgee_id True integer

The system record ID of the gift tribute acknowledgee to update.

Letter
letter integer

The letter sent to the acknowledgee.

Letter date
letter_date date-time

The date on which the letter was sent.

Update gift acknowledgement details

Updates the acknowledgement details for a gift.

Parameters

Name Key Required Type Description
Acknowledgement ID
acknowledgement_id True string

The system record ID of the gift acknowledgement to update. It uses the parent gift's ID as its value.

Status
status string

The status of the acknowledgement. When status is set to DoNotAcknowledge, letter and date should be null. When status is set to NeedsAcknowledgement, date should be null.

Date
date date-time

The date associated with the acknowledgement (ex: '2020-09-18T04:13:56Z').

Letter
letter string

The letter associated with the acknowledgement.

Update gift receipt details

Updates the receipt details for a gift.

Parameters

Name Key Required Type Description
Receipt ID
receipt_id True string

The system record ID of the gift receipt to update. It uses the parent gift's ID as its value.

Status
status string

The receipt status of the gift. When status is set to NeedsReceipt or DoNotReceipt, receipt date should be null.

value
value double

The monetary value.

Date
date date-time

The date on the receipt (ex: '2020-09-18T04:13:56Z').

Number
number integer

The number of the receipt.

Definitions

ConstituentApi.AppealRead

Name Path Type Description
ID
id string

The system record ID of the appeal.

description
description string

The appeal description.

ConstituentApi.CampaignRead

Name Path Type Description
ID
id string

The system record ID of the campaign.

description
description string

The campaign description.

ConstituentApi.FundRead

Name Path Type Description
ID
id string

The system record ID of the fund.

description
description string

The fund description.

ConstituentApi.GivingSummaryRead

Giving summary

Name Path Type Description
ID
id string

The system record ID of the gift.

Type
type string

The gift type.

Date
date date-time

The gift date.

value
amount.value double

The monetary value.

Appeal
appeals array of ConstituentApi.AppealRead

The set of appeals associated with the gift.

Campaign
campaigns array of ConstituentApi.CampaignRead

The set of campaigns associated with the gift.

Fund
funds array of ConstituentApi.FundRead

The set of funds associated with the gift.

ConstituentApi.LifetimeGivingRead

Lifetime giving

Name Path Type Description
Consecutive years given
consecutive_years_given integer

The number of consecutive years the constituent has given.

Total years given
total_years_given integer

The total number of years the constituent has given.

value
total_giving.value double

The monetary value.

value
total_pledge_balance.value double

The monetary value.

value
total_received_giving.value double

The monetary value.

value
total_committed_matching_gifts.value double

The monetary value.

value
total_received_matching_gifts.value double

The monetary value.

value
total_soft_credits.value double

The monetary value.

GiftApi.AcknowledgementRead

Acknowledgement

Name Path Type Description
date
date date-time

The date associated with the acknowledgement.

letter
letter string

The letter associated with the acknowledgement.

status
status string

The status of the acknowledgement. Available values are: ACKNOWLEDGED, NEEDSACKNOWLEDGEMENT, and DONOTACKNOWLEDGE.

GiftApi.ApiCollectionOfGiftAttachmentRead

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 GiftApi.GiftAttachmentRead

The set of items included in the response. This may be a subset of the items in the collection.

GiftApi.ApiCollectionOfGiftCustomFieldRead

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 GiftApi.GiftCustomFieldRead

The set of items included in the response. This may be a subset of the items in the collection.

GiftApi.ApiCollectionOfGiftRead

Gifts

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 GiftApi.GiftRead

The set of items included in the response. This may be a subset of the items in the collection.

GiftApi.BatchGiftAddResults

Contains a collection of batch gift error records and the batch gifts that the operation added

Name Path Type Description
errors
errors array of GiftApi.GiftBatchGiftError

The batch gift errors associated with the batch gift add operation

gifts
gifts array of GiftApi.BatchGiftRead

The collection of batch gifts that were added by the batch gift add operation

GiftApi.GiftBatchGiftError

Represents exceptions preventing items from being added to the batch.

Name Path Type Description
affected field
affected_field string

The field affected by the error

batch ID
batch_id string

The system record ID of the batch

exception error code
exception_error_code integer

The exception error code

exception error message
exception_error_message string

The exception error message

exception error name
exception_error_name string

The exception error name

gift ID
gift_id string

The system record ID of the gift

lookup ID
lookup_id string

The user-defined identifier for the gift.

GiftApi.BatchGiftRead

Batch gift

Name Path Type Description
batch ID
batch_id string

The ID of the batch to which the gift was added.

errors
errors array of GiftApi.GiftBatchGiftError

The errors associated with the batch gift.

ID
id string

The system record ID of the batch gift.

constituent ID
constituent_id string

The system record ID of the constituent associated with the gift.

type
type string

The gift type.

subtype
subtype string

The subtype of the gift.

date
date date-time

The gift date.

value
amount.value double

The monetary value.

value
balance.value double

The monetary value.

batch number
batch_number string

The batch number associated with this gift.

status
gift_status string

The status of the gift.

anonymous?
is_anonymous boolean

Is the gift anonymous?

constituency
constituency string

The constituency of the gift.

lookup ID
lookup_id string

The user-defined identifier for the gift.

origin
origin string

The origin of the gift.

post status
post_status string

The general ledger post status of the gift. Available values are Posted, NotPosted, and DoNotPost. When post_status is set to DoNotPost>, post_date should be null. When it is set to NotPosted, post_date is required but remains editable. When it is set to Posted, post_date is required and is no longer editable.

post date
post_date date-time

The date that the gift was posted to general ledger.

reference
reference string

Notes to track special details about a gift such as the motivation behind it or a detailed description of a gift-in-kind.

day
recurring_gift_status_date.d integer

The day in the fuzzy date.

month
recurring_gift_status_date.m integer

The month in the fuzzy date.

year
recurring_gift_status_date.y integer

The year in the fuzzy date.

frequency
recurring_gift_schedule.frequency string

Installment frequency of the recurring gift to view. Available values are WEEKLY, EVERY_TWO_WEEKS, EVERY_FOUR_WEEKS, MONTHLY, QUARTERLY, ANNUALLY.

start
recurring_gift_schedule.start_date date-time

Date the recurring gift should start.

end
recurring_gift_schedule.end_date date-time

Date the recurring gift should end.

value
gift_aid_amount.value double

The monetary value.

gift aid qualification status
gift_aid_qualification_status string

This computed field determines the Gift Aid qualification status based on tax declaration information and the database format. Available values are: Qualified, NotQualified, and PartlyQualified. For the UK only.

gift code
gift_code string

The gift code value associated with the gift.

gift splits
gift_splits array of GiftApi.GiftSplitRead

The set of gift splits associated with the gift.

fundraisers
fundraisers array of GiftApi.GiftFundraiserRead

The set of fundraisers who receive credit for the gift.

Soft credits
soft_credits array of GiftApi.SoftCreditRead

The set of soft credits associated with the gift.

Receipts
receipts array of GiftApi.ReceiptRead

The set of receipts associated with the gift.

Acknowledgements
acknowledgements array of GiftApi.AcknowledgementRead

The set of acknowledgements associated with the gift.

Payments
payments array of GiftApi.PaymentRead

The payments on the gift.

Linked gifts
linked_gifts array of string

The identifiers of other gifts that are linked to this gift.

Date added
date_added date-time

The date when the gift was created.

Date modified
date_modified date-time

The date when the gift was last modified.

GiftApi.CreatedGift

Created gift

Name Path Type Description
ID
id string

The ID of the newly created gift.

GiftApi.CreatedGiftAttachment

Created gift attachment

Name Path Type Description
ID
id string

The ID of the newly created gift attachment.

GiftApi.CreatedGiftCustomField

Created gift custom field

Name Path Type Description
ID
id string

The ID of the newly created gift custom field.

GiftApi.GiftAttachmentRead

Attachment

Name Path Type Description
ID
id string

The system record ID of the attachment.

Gift ID
parent_id string

The system record ID of the gift 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.

GiftApi.GiftCustomFieldRead

Custom field

Name Path Type Description
ID
id string

The system record ID of the custom field.

Gift ID
parent_id string

The system record ID of the gift 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.

GiftApi.GiftFundraiserRead

Gift fundraiser

Name Path Type Description
value
amount.value double

The monetary value.

fundraiser ID
constituent_id string

The constituent system record ID for the fundraiser associated with the gift.

GiftApi.GiftRead

Gift

Name Path Type Description
ID
id string

The system record ID of the gift.

Constituent ID
constituent_id string

The system record ID of the constituent associated with the gift.

Type
type string

The gift type.

Subtype
subtype string

The subtype of the gift.

Date
date date-time

The gift date.

value
amount.value double

The monetary value.

value
balance.value double

The monetary value.

Batch number
batch_number string

The batch number associated with this gift.

Status
gift_status string

The status of the gift.

Anonymous?
is_anonymous boolean

Is the gift anonymous?

Constituency
constituency string

The constituency of the gift.

Lookup ID
lookup_id string

The user-defined identifier for the gift.

Origin
origin string

The origin of the gift.

Post status
post_status string

The general ledger post status of the gift. Available values are Posted, NotPosted, and DoNotPost. When post_status is set to DoNotPost>, post_date should be null. When it is set to NotPosted, post_date is required but remains editable. When it is set to Posted, post_date is required and is no longer editable.

Post date
post_date date-time

The date that the gift was posted to general ledger.

Reference
reference string

Notes to track special details about a gift such as the motivation behind it or a detailed description of a gift-in-kind.

day
recurring_gift_status_date.d integer

The day in the fuzzy date.

month
recurring_gift_status_date.m integer

The month in the fuzzy date.

year
recurring_gift_status_date.y integer

The year in the fuzzy date.

frequency
recurring_gift_schedule.frequency string

Installment frequency of the recurring gift to view. Available values are WEEKLY, EVERY_TWO_WEEKS, EVERY_FOUR_WEEKS, MONTHLY, QUARTERLY, ANNUALLY.

start
recurring_gift_schedule.start_date date-time

Date the recurring gift should start.

end
recurring_gift_schedule.end_date date-time

Date the recurring gift should end.

value
gift_aid_amount.value double

The monetary value.

Gift aid qualification status
gift_aid_qualification_status string

This computed field determines the Gift Aid qualification status based on tax declaration information and the database format. Available values are: Qualified, NotQualified, and PartlyQualified. For the UK only.

Gift code
gift_code string

The gift code value associated with the gift.

Gift splits
gift_splits array of GiftApi.GiftSplitRead

The set of gift splits associated with the gift.

Fundraisers
fundraisers array of GiftApi.GiftFundraiserRead

The set of fundraisers who receive credit for the gift.

Soft credits
soft_credits array of GiftApi.SoftCreditRead

The set of soft credits associated with the gift.

Receipts
receipts array of GiftApi.ReceiptRead

The set of receipts associated with the gift.

Acknowledgements
acknowledgements array of GiftApi.AcknowledgementRead

The set of acknowledgements associated with the gift.

Payments
payments array of GiftApi.PaymentRead

The payments on the gift.

Linked gifts
linked_gifts array of string

The identifiers of other gifts that are linked to this gift.

Date added
date_added date-time

The date when the gift was created.

Date modified
date_modified date-time

The date when the gift was last modified.

GiftApi.GiftSplitRead

Gift split

Name Path Type Description
ID
id string

The system record ID of the gift split.

value
amount.value double

The monetary value.

appeal ID
appeal_id string

The system record ID of the appeal associated with the gift split.

campaign ID
campaign_id string

The system record ID of the campaign associated with the gift split.

fund ID
fund_id string

The system record ID of the fund associated with the gift split.

value
gift_aid_amount.value double

The monetary value.

gift aid qualification status
gift_aid_qualification_status string

The gift aid qualification status of the gift split. Available values are: Qualified, and NotQualified. For the UK only.

package ID
package_id string

The system record ID of the package associated with the gift split.

GiftApi.ReceiptRead

Receipt

Name Path Type Description
value
amount.value double

The monetary value.

date
date date-time

The date on the receipt.

number
number integer

The number of the receipt.

status
status string

The status of the receipt. Available values are: RECEIPTED, NEEDSRECEIPT, and DONOTRECEIPT.

GiftApi.PaymentRead

Payment

Name Path Type Description
account token
account_token string

The tokenized account information (ex: credit card) from the external payment provider. Only applies to payment methods of "CreditCard" and "DirectDebit".

BBPS configuration ID
bbps_configuration_id string

The BBPS configuration ID. Only applies to payment methods of "CreditCard" and "DirectDebit".

BBPS transaction ID
bbps_transaction_id string

The BBPS transaction ID. Only applies to payment methods of "CreditCard" and "DirectDebit".

day
check_date.d integer

The day in the fuzzy date.

month
check_date.m integer

The month in the fuzzy date.

year
check_date.y integer

The year in the fuzzy date.

check number
check_number string

The check number. Only applies to payment method of "PersonalCheck".

checkout transaction ID
checkout_transaction_id string

The checkout transaction ID. Only applies to payment methods of "CreditCard" and "DirectDebit".

payment method
payment_method string

The payment method. Available values are listed below.

reference
reference string

The reference. Only applies to payment method of "Other".

day
reference_date.d integer

The day in the fuzzy date.

month
reference_date.m integer

The month in the fuzzy date.

year
reference_date.y integer

The year in the fuzzy date.

GiftApi.SoftCreditRead

Soft credit

Name Path Type Description
ID
id string

The system record ID of the soft credit.

value
amount.value double

The monetary value.

constituent ID
constituent_id string

The system record ID of the constituent associated with the soft credit.

gift ID
gift_id string

The system record ID of the gift associated with the soft credit.

GiftBatchApi.ApiCollectionOfGiftBatch

Gift batches

Name Path Type Description
Count
count integer

The total number of gift batches in the response.

value
value array of GiftBatchApi.GiftBatch

The set of items included in the response.

GiftBatchApi.CreatedBatch

Created gift batch

Name Path Type Description
ID
batch_id string

The system record ID of the newly created gift batch.

GiftBatchApi.GiftBatch

Represents the gift batch object

Name Path Type Description
ID
id string

The system record ID of the batch.

description
batch_description string

The batch description.

batch number
batch_number string

The batch number

projected number
projected_number_of_gifts integer

The projected number of gifts in the batch.

actual number
number_of_gifts integer

The actual number of gifts in the batch.

projected amount
projected_amount double

The projected value of gifts in the batch.

actual amount
actual_amount double

The actual value of gifts in the batch.

has exceptions?
has_exceptions boolean

Does the batch have exceptions?

approved?
is_approved boolean

Is the batch approved?

Created by
created_by string

The name of the user who created the batch.

Created on
created_on date-time

The date when the batch was created.

NXTDataIntegrationApi.CreatedGiftNote

Created note

Name Path Type Description
ID
id string

The ID of the newly created note.

NXTDataIntegrationApi.CreatedGiftTribute

Created gift tribute

Name Path Type Description
ID
id string

The ID of the newly created gift tribute.

NXTDataIntegrationApi.CreatedTaxDeclaration

Created tax declaration

Name Path Type Description
ID
id string

The ID of the newly created tax declaration.

NXTDataIntegrationApi.GiftIdMap

Gift ID map

Name Path Type Description
ID
system_record_id integer

The gift system record ID.

NXTDataIntegrationApi.GiftNote

Note

Name Path Type Description
Gift ID
gift_id integer

The system record ID of the gift associated with the note.

Type
type string

The note type.

day
date.d integer

The day in the fuzzy date.

month
date.m integer

The month in the fuzzy date.

year
date.y integer

The year in the fuzzy date.

Summary
summary string

The note summary.

Note
text string

The note text.

Author
author string

The author of the note.

NXTDataIntegrationApi.GiftNoteCollection

Gift notes

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 NXTDataIntegrationApi.GiftNote

The set of items included in the response. This may be a subset of the items in the collection.

NXTDataIntegrationApi.GiftTribute

Gift tribute

Name Path Type Description
ID
id integer

The system record ID of the gift tribute.

Gift ID
gift_id integer

The system record ID of the gift.

Tribute ID
tribute_id integer

The system record ID of the tribute.

Tribute type
tribute_type integer

The tribute type.

Acknowledge status
acknowledge string

The gift tribute acknowledge status.

Sequence
sequence integer

The gift tribute sequence.

NXTDataIntegrationApi.GiftTributeAcknowledgee

A gift tribute acknowledgee record in Raiser's Edge.

Name Path Type Description
ID
id integer

The system record ID of the gift tribute acknowledgee.

Gift tribute ID
gift_tribute_id integer

The system record ID of the gift tribute.

Is self acknowledge?
self_acknowledge boolean

Is this acknowledgee a self-acknowledge?

Relationships ID
relationships_id integer

The system record ID of the relationship for the acknowledgee.

Letter
letter integer

The letter sent to the acknowledgee.

Letter date
letter_date date-time

The date on which the letter was sent.

NXTDataIntegrationApi.GiftTributeAcknowledgeeCollection

Gift tribute acknowledgees

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 NXTDataIntegrationApi.GiftTributeAcknowledgee

The set of items included in the response. This may be a subset of the items in the collection.

NXTDataIntegrationApi.GiftTributeCollection

Gift tributes

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 NXTDataIntegrationApi.GiftTribute

The set of items included in the response. This may be a subset of the items in the collection.

NXTDataIntegrationApi.TaxDeclaration

Name Path Type Description
ID
declaration_id integer
Declaration starts
declaration_starts date-time

The date the tax declaration starts.

Declaration ends
declaration_ends date-time

The date the tax declaration ends.

Declaration made
declaration_made date-time

The date the tax declaration was made.

Indicator ID
declaration_indicator_id integer

The declaration indicator ID.

Indicator
declaration_indicator string

The declaration indicator.

Source ID
declaration_source_id integer

The declaration source ID.

Source
declaration_source string

The declaration source.

Confirmation sent
confirmation_sent date-time

The date the confirmation was sent.

Confirmation returned
confirmation_returned date-time

The date the confirmation was returned.

Pays tax
constituent_pays_tax string

Indicates whether the constituent pays tax.

Status ID
tax_payer_status_id integer

The tax payer status ID.

Status
tax_payer_status string

The tax payer status.

Comments
tax_notes string

Comments for the tax declaration.

Sequence
sequence integer

The numeric sequence associated with the tax declaration.

NXTDataIntegrationApi.TaxDeclarationCollection

Tax declarations

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 NXTDataIntegrationApi.TaxDeclaration

The set of items included in the response. This may be a subset of the items in the collection.