Blackbaud Raisers Edge NXT Constituents
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 Constituents connector to manage constituent biographical details, contact information, and relationships.
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 |
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 constituents and related entities found within The Raiser's Edge NXT, including:
- Constituents
- Addresses
- Phones and emails
- Aliases
- Custom fields
- Notes
- Attachments
- Relationships
- 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
Convert to constituent |
Converts a non-constituent to a constituent. |
Create a constituent address |
Creates a new constituent address. |
Create a constituent alias |
Creates a new constituent alias. |
Create a constituent attachment |
Creates a new constituent attachment. |
Create a constituent code |
Creates a new constituent code. |
Create a constituent consent record |
Creates a new constituent consent record. |
Create a constituent custom field |
Creates a new constituent custom field. |
Create a constituent education |
Creates a new constituent education. |
Create a constituent email address |
Creates a new constituent email address. |
Create a constituent name format |
Creates a new constituent name format. |
Create a constituent note |
Creates a new constituent note. |
Create a constituent online presence |
Creates a new constituent online presence. |
Create a constituent phone |
Creates a new constituent phone. |
Create a constituent primary name format |
Creates a primary name format for a constituent. |
Create a constituent solicit code |
Creates a new constituent solicit code. |
Create a constituent tribute |
Creates a new constituent tribute. |
Create a fundraiser assignment |
Creates a new fundraiser assignment. |
Create a tribute acknowledgee |
Creates a new tribute acknowledgee. |
Create an individual constituent |
Creates a new individual constituent. |
Create an individual relationship |
Creates a new individual relationship. If the relationship is with another constituent, a reciprocal relationship is created for that constituent. |
Create an organization constituent |
Creates a new organization constituent. |
Create an organization relationship |
Creates a new organization relationship. If the relationship is with another constituent, a reciprocal relationship is created for that constituent. |
Delete a constituent code |
Deletes a constituent code. |
Get a constituent |
Returns information about a constituent. |
Get a constituent by lookup ID |
Returns a constituent's system record ID from the specified lookup ID. |
Get a constituent profile picture |
Returns the current profile picture for a constituent. |
Get a constituent tribute |
Returns details about a constituent tribute. |
Get constituent name format summary |
Returns the name format summary for a constituent. |
List constituent addresses |
Lists the addresses for a constituent. |
List constituent aliases |
Lists the aliases for a constituent. |
List constituent attachments |
Lists the attachments for a constituent. |
List constituent codes |
Lists the constituent codes for a constituent. |
List constituent consent records |
Lists the consent records for a constituent. |
List constituent custom fields |
Lists the custom fields for a constituent. |
List constituent educations |
Lists the education records for a constituent. |
List constituent email addresses |
Lists the email addresses for a constituent. |
List constituent fundraisers |
Lists the fundraiser assignments for a constituent. |
List constituent memberships |
Lists the memberships for a constituent. |
List constituent notes |
Lists the notes for a constituent. |
List constituent online presences |
Lists the online presences for a constituent. |
List constituent phones |
Lists the phones for a constituent. |
List constituent relationships |
Lists the relationships for a constituent. |
List constituent solicit codes |
Lists the solicit codes for a constituent. |
List constituent tributes |
Lists the tributes for a constituent. |
List constituents |
Returns a list of constituents. |
List fundraiser assignments |
List the assignments for a fundraiser. |
List tribute acknowledgees |
Lists the acknowledgees for a tribute. |
Search for a constituent |
Performs a constituent search based on the provided search text. Supports first name, last name, preferred name, former name, alias, email address, phone number, address, or lookup ID. Name combinations such as first name and last name or preferred name and last name are valid, but otherwise search only supports one parameter at a time. By default, searches include results that sound similar to your criteria. For example, searches for "Smith" include matches for "Smyth" and other alternative spellings. This search does not support wildcard characters such as * or ?. Search results are limited to 500 records. |
Search for a constituent (enhanced) |
Searches for constituent records using the given filter criteria. |
Search for duplicate constituents |
Searches individual, organization, and related contact records and ranks potential duplicates based on the specified search filters. Records that match multiple filters rank higher as potential duplicates. |
Update a constituent |
Updates a constituent. |
Update a constituent address |
Updates a constituent address. |
Update a constituent alias |
Updates an constituent alias. |
Update a constituent attachment |
Updates a constituent attachment. |
Update a constituent code |
Updates a constituent code. |
Update a constituent custom field |
Updates a constituent custom field. |
Update a constituent education |
Updates a constituent education. |
Update a constituent email address |
Updates a constituent email address. |
Update a constituent name format |
Updates a constituent name format. |
Update a constituent note |
Updates a constituent note. |
Update a constituent online presence |
Updates a constituent online presence. |
Update a constituent phone |
Updates a constituent phone. |
Update a constituent primary name format |
Updates the primary name format for a constituent. |
Update a constituent profile picture |
Updates the current profile picture for a constituent. |
Update a constituent relationship |
Updates a relationship for a constituent. If a reciprocal relationship exists, it is also modified to reflect the changes. This does not include changes to the "comments" property, which is specific to each record and can be modified independently on each record. |
Update a constituent solicit code |
Updates a constituent solicit code. |
Convert to constituent
Converts a non-constituent to a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Non-constituent ID
|
non_constituent_id | True | string |
The system record ID of the non-constituent record to convert. |
ID
|
id | string |
The system record ID of the constituent code. |
|
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. |
|
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. |
|
sequence
|
sequence | integer |
The sequence of the constituent code. |
Returns
Converted constituent
Create a constituent address
Creates a new constituent address.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the address. |
Address type
|
type | True | string |
The address type. |
Country
|
country | string |
The country of the address (can be the ID, name, or abbreviation). |
|
Address lines
|
address_lines | string |
The address lines. |
|
City
|
city | string |
The city of the address (do not use in combination with the Suburb field). |
|
State
|
state | string |
The state of the address. |
|
Postal code
|
postal_code | string |
The postal code of the address. |
|
Suburb
|
suburb | string |
The suburb of the address (do not use in combination with the City field). |
|
County
|
county | string |
The county of the address. |
|
Information source
|
information_source | string |
The information source for the address. |
|
Region
|
region | string |
The region for the address. |
|
CART
|
cart | string |
The carrier route (CART) for the address. |
|
LOT
|
lot | string |
The line of travel (LOT) for the address. |
|
DPC
|
dpc | string |
The delivery point code (DPC) for the address. |
|
Valid from
|
start | date |
The date when the constituent began residing at this address (ex: '2005-09-18'). |
|
Valid to
|
end | date |
The date when the constituent ceased to reside at this address (ex: '2005-09-18'). |
|
Primary?
|
preferred | boolean |
Is this the constituent's preferred address? |
|
Do not mail?
|
do_not_mail | boolean |
Can the constituent be contacted at this address? |
|
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. |
|
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. |
Returns
Created constituent address
Create a constituent alias
Creates a new constituent alias.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the alias. |
Alias
|
name | True | string |
The name to use as the constituent's alias. Character limit: 100. |
Type
|
type | string |
The alias type. |
Returns
Created constituent alias
Create a constituent attachment
Creates a new constituent attachment.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
parent_id | True | string |
The system record ID of the constituent 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 constituent attachment
Create a constituent code
Creates a new constituent code.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the constituent code. |
Constituent code
|
description | True | string |
The constituent code. |
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. |
|
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. |
|
Sequence
|
sequence | integer |
The numeric sequence associated with the constituent code. |
Returns
Created constituent code
Create a constituent consent record
Creates a new constituent consent record.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the consent record. |
Channel
|
channel | True | string |
The channel that the consent response applies to. |
Category
|
category | string |
The category that the consent response applies to. |
|
Source
|
source | string |
The source of the consent response from the constituent. |
|
Response
|
constituent_consent_response | True | string |
How the constituent responded to consent for the specified channel/category. |
Date
|
consent_date | True | date-time |
The date the consent response was received (ex: '2020-09-18T04:13:56Z'). |
Consent statement
|
consent_statement | string |
The statement the constituent responded to when providing consent. |
|
Privacy notice
|
privacy_notice | string |
The privacy notice provided to the constituent. |
Returns
Created constituent consent
Create a constituent custom field
Creates a new constituent custom field.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
body
|
body | True | dynamic |
An object that represents the custom field to create. |
Returns
Created constituent custom field
Create a constituent education
Creates a new constituent education.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the education. |
School
|
school | True | string |
The school/establishment name. |
Type
|
type | string |
The type of education. |
|
Class of
|
class_of | string |
The year the constituent graduated. |
|
Status
|
status | string |
The status of the education. |
|
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. |
|
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. |
|
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. |
|
Degree
|
degree | string |
The degree received. |
|
GPA
|
gpa | double |
The grade point average. |
|
Subject of study
|
subject_of_study | string |
The subject of study. |
|
Primary?
|
primary | boolean |
Is this the constituent's primary school association? |
|
Majors
|
majors | array of string |
The major courses of study. |
|
Minors
|
minors | array of string |
The minor courses of study. |
|
Campus
|
campus | string |
The campus. Character limit: 50. |
|
Social organization
|
social_organization | string |
The social organization. Character limit: 50. |
|
Known name
|
known_name | string |
The known name. Character limit: 50. |
|
Class of degree
|
class_of_degree | string |
The class of degree (only applicable for UK versions). |
|
Department
|
department | string |
The name of the education department (only applicable for UK versions). |
|
Faculty
|
faculty | string |
The name of the faculty (only applicable for UK versions). |
|
Registration number
|
registration_number | string |
The registration number (only applicable for UK versions). Character limit: 50. |
Returns
Created constituent education
Create a constituent email address
Creates a new constituent email address.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the email address. |
Email type
|
type | True | string |
The type of email address. |
Email address
|
address | True | string |
The email address. |
Primary?
|
primary | boolean |
Is this the constituent's primary email address? |
|
Do not email?
|
do_not_email | boolean |
Can the constituent be contacted at this email address? |
|
Inactive?
|
inactive | boolean |
Is this email address inactive? |
Returns
Created constituent email address
Create a constituent name format
Creates a new constituent name format.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Type
|
type | True | string |
The name format type. |
Custom name format?
|
custom_format | boolean |
Is a custom format? |
|
Format
|
configuration_id | string |
Name format configuration (required unless a custom format is used). |
|
Custom name
|
formatted_name | string |
Formatted name (required when a custom format is used). Character limit: 255. |
Returns
Created name format
Create a constituent note
Creates a new constituent note.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the note. |
Type
|
type | True | string |
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: 50. |
|
Note
|
text | string |
The note text. |
|
Author
|
author | string |
The note author. If not supplied, will have a default set based on the user's account. Character limit: 50. |
Returns
Created constituent note
Create a constituent online presence
Creates a new constituent online presence.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the online presence. |
Type
|
type | True | string |
The online presence type. |
Link
|
address | True | string |
The web address for the online presence. |
Primary?
|
primary | boolean |
Is this the constituent's primary online presence? |
|
Inactive?
|
inactive | boolean |
Is this online presence inactive? |
Returns
Created constituent online presence
Create a constituent phone
Creates a new constituent phone.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the phone. |
Type
|
type | True | string |
The phone type. |
Number
|
number | True | string |
The phone number. |
Primary?
|
primary | boolean |
Is this the constituent's primary phone? |
|
Do not call?
|
do_not_call | boolean |
Can the constituent be contacted at this number? |
|
Inactive?
|
inactive | boolean |
Is this phone number inactive? |
Returns
Created constituent phone
Create a constituent primary name format
Creates a primary name format for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Type
|
primary_type | True | string |
The primary name format type. |
Custom name format?
|
custom_format | boolean |
Is a custom format? |
|
Format
|
configuration_id | string |
Name format configuration (required unless a custom format is used). |
|
Custom name
|
formatted_name | string |
Formatted name (required when a custom format is used). Character limit: 255. |
Returns
Created name format
Create a constituent solicit code
Creates a new constituent solicit code.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the solicit code. |
Solicit code
|
solicit_code | True | string |
Communication instructions and/or restrictions for a constituent. |
Start date
|
start_date | date |
The start date of the solicit code (ex: '2005-09-18'). |
|
End date
|
end_date | date |
The end date of the solicit code (ex: '2005-09-18'). |
Returns
Created constituent solicit code
Create a constituent tribute
Creates a new constituent tribute.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_record_id | True | integer |
The system record ID of the constituent associated with the tribute. |
Tribute type
|
tribute_type_id | True | integer |
The tribute type. |
Description
|
description | string |
The tribute description. |
|
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. |
|
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. |
|
Default fund ID
|
default_fund_id | integer |
The system record ID of the default fund associated with the tribute. |
|
Notes
|
notes | string |
The tribute notes. |
|
Active?
|
is_active | boolean |
Is this tribute active? |
Returns
Created constituent tribute
Create a fundraiser assignment
Creates a new fundraiser assignment.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Fundraiser ID
|
fundraiser_id | True | string |
The system record ID of the fundraiser. |
Constituent ID
|
constituent_id | True | string |
The system record ID of the assigned constituent. |
Type
|
type | string |
The type of fundraiser. |
|
Assignment starts
|
start | date-time |
The start date of the assignment (ex: '2020-09-18T04:13:56Z'). |
|
Assignment ends
|
end | date-time |
The end date of the assignment (ex: '2020-09-18T04:13:56Z'). |
|
Amount
|
value | True | double |
The goal amount for the fundraiser to solicit from the assigned constituent. |
Campaign ID
|
campaign_id | string |
The system record ID of the campaign to which which resulting gifts will be applied. |
|
Fund ID
|
fund_id | string |
The system record ID of the fund to which which resulting gifts will be applied. |
|
Appeal ID
|
appeal_id | string |
The system record ID of the appeal to which which resulting gifts will be applied. |
Returns
Created fundraiser assignment
Create a tribute acknowledgee
Creates a new tribute acknowledgee.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Tribute ID
|
tribute_id | True | integer |
The system record ID of the tribute associated with the acknowledgee. |
Relationship ID
|
relationship_id | integer |
The system record ID of the relationship (if null, this represents a self-acknowledgee). |
|
Letter ID
|
letter_id | integer |
The letter ID. |
Returns
Created tribute acknowledgee
Create an individual constituent
Creates a new individual constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Title
|
title | string |
The constituent's primary title. |
|
First name
|
first | string |
The constituent's first name. Character limit: 50. |
|
Last name
|
last | True | string |
The constituent's last name. Character limit: 100. |
Suffix
|
suffix | string |
The constituent's primary suffix. |
|
Lookup ID
|
lookup_id | string |
The user-defined identifier for the constituent. |
|
type
|
type | True | string |
The address type. |
country
|
country | string |
The country of the address (can be the ID, name, or abbreviation). |
|
lines
|
address_lines | string |
The address lines. Character limit: 150. |
|
city
|
city | string |
The city of the address (do not use in combination with the Suburb field). |
|
state
|
state | string |
The state of the address. |
|
postal code
|
postal_code | string |
The postal code of the address. Character limit: 12. |
|
suburb
|
suburb | string |
The suburb of the address (do not use in combination with the City field). |
|
county
|
county | string |
The county of the address. |
|
start
|
start | date |
The date when the constituent began residing at this address (ex: '2005-09-18'). |
|
end
|
end | date |
The date when the constituent ceased to reside at this address (ex: '2005-09-18'). |
|
type
|
type | True | string |
The phone type. |
number
|
number | True | string |
The phone number. |
is primary?
|
primary | boolean |
Is this the constituent's primary phone number? |
|
type
|
type | True | string |
The type of email address. |
address
|
address | True | string |
The email address. |
is primary?
|
primary | boolean |
Is this the constituent's primary email address? |
|
type
|
type | True | string |
The online presence type. |
address
|
address | True | string |
The web address for the online presence. |
is primary?
|
primary | boolean |
Is this the constituent's primary online presence? |
|
Preferred name
|
preferred_name | string |
The constituent's preferred name. Character limit: 50. |
|
Middle name
|
middle | string |
The constituent's middle name. Character limit: 50. |
|
Former name
|
former_name | string |
The constituent's former name. Character limit: 100. |
|
Title 2
|
title_2 | string |
The constituent's secondary title. |
|
Suffix 2
|
suffix_2 | string |
The constituent's secondary suffix. |
|
Gender
|
gender | string |
The constituent's gender. |
|
Marital status
|
marital_status | string |
The constituent's marital status. |
|
Gives anonymously?
|
gives_anonymously | boolean |
Does the constituent give anonymously? |
|
Requests no email?
|
requests_no_email | boolean |
Does the constituent request no email? |
|
Is a solicitor?
|
is_solicitor | boolean |
Is the constituent a solicitor? |
|
No valid addresses?
|
no_valid_address | boolean |
Does the constituent have no valid addresses? |
|
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. |
|
Birthplace
|
birthplace | string |
The birthplace of the constituent. |
|
Ethnicity
|
ethnicity | string |
The ethnicity of the constituent. |
|
Target
|
target | string |
The target of the constituent. |
|
Income
|
income | string |
The income for the constituent. |
|
Receipt type
|
receipt_type | string |
The receipt type of the constituent. |
|
Religion
|
religion | string |
The religion of the constituent. |
|
Custom addressee?
|
custom_format | boolean |
Is the primary addressee a custom format? |
|
Addressee format
|
configuration_id | string |
Primary addressee configuration (required unless a custom format is used). |
|
Addressee custom name
|
formatted_name | string |
Primary addressee formatted name (required when a custom format is used). Character limit: 255. |
|
Custom salutation?
|
custom_format | boolean |
Is the primary salutation a custom format? |
|
Salutation format
|
configuration_id | string |
Primary salutation configuration (required unless a custom format is used). |
|
Salutation custom name
|
formatted_name | string |
Primary salutation formatted name (required when a custom format is used). Character limit: 255. |
|
Is memorial?
|
is_memorial | boolean |
Is the constituent an honor/memorial? |
Returns
Created individual constituent
Create an individual relationship
Creates a new individual relationship. If the relationship is with another constituent, a reciprocal relationship is created for that constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the relationship. |
Relation ID
|
relation_id | True | string |
The system record ID of the related individual. |
Type
|
type | string |
The type of relation that the relationship represents. |
|
Reciprocal type
|
reciprocal_type | string |
Describes the constituent's relationship to the related constituent. For example, in a relationship between a male constituent and a female sibling, the reciprocal relationship type would be brother. |
|
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. |
|
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 spouse?
|
is_spouse | boolean |
Is the related individual the constituent's spouse? |
|
Is constituent head of household?
|
is_constituent_head_of_household | boolean |
Is the constituent the head of the household? |
|
Is spouse head of household?
|
is_spouse_head_of_household | boolean |
Is the spouse the head of the household? |
|
Notes
|
comment | string |
Additional notes about the relationship. |
Returns
Created individual relationship
Create an organization constituent
Creates a new organization constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name
|
name | True | string |
The organization name. Character limit: 100. |
Lookup ID
|
lookup_id | string |
The user-defined identifier for the constituent. |
|
type
|
type | True | string |
The address type. |
country
|
country | string |
The country of the address (can be the ID, name, or abbreviation). |
|
lines
|
address_lines | string |
The address lines. Character limit: 150. |
|
city
|
city | string |
The city of the address (do not use in combination with the Suburb field). |
|
state
|
state | string |
The state of the address. |
|
postal code
|
postal_code | string |
The postal code of the address. Character limit: 12. |
|
suburb
|
suburb | string |
The suburb of the address (do not use in combination with the City field). |
|
county
|
county | string |
The county of the address. |
|
start
|
start | date |
The date when the constituent began residing at this address (ex: '2005-09-18'). |
|
end
|
end | date |
The date when the constituent ceased to reside at this address (ex: '2005-09-18'). |
|
type
|
type | True | string |
The phone type. |
number
|
number | True | string |
The phone number. |
is primary?
|
primary | boolean |
Is this the constituent's primary phone number? |
|
type
|
type | True | string |
The type of email address. |
address
|
address | True | string |
The email address. |
is primary?
|
primary | boolean |
Is this the constituent's primary email address? |
|
type
|
type | True | string |
The online presence type. |
address
|
address | True | string |
The web address for the online presence. |
is primary?
|
primary | boolean |
Is this the constituent's primary online presence? |
|
Gives anonymously?
|
gives_anonymously | boolean |
Does the constituent give anonymously? |
|
Requests no email?
|
requests_no_email | boolean |
Does the constituent request no email? |
|
Is a solicitor?
|
is_solicitor | boolean |
Is the constituent a solicitor? |
|
No valid addresses?
|
no_valid_address | boolean |
Does the constituent have no valid addresses? |
|
Target
|
target | string |
The target of the constituent. |
|
Income
|
income | string |
The income for the constituent. |
|
Receipt type
|
receipt_type | string |
The receipt type of the constituent. |
|
Industry
|
industry | string |
The industry of the constituent. |
|
Number of employees
|
num_employees | integer |
The number of employees at the organization. |
|
Matches gifts?
|
matches_gifts | boolean |
Does the organization match gifts? |
|
Matching gift factor
|
matching_gift_factor | double |
The matching gift factor. |
|
Min match per gift
|
value | double |
The minimum match amount per gift for the constituent. |
|
Max match per gift
|
value | double |
The maximum match amount per gift for the constituent. |
|
Min match per constit
|
value | double |
The minimum match total for the constituent. |
|
Max match per constit
|
value | double |
The maximum match total for the constituent. |
|
Matching gift notes
|
matching_gift_notes | string |
The matching gift notes for the constituent. |
|
Is memorial?
|
is_memorial | boolean |
Is the constituent an honor/memorial? |
Returns
Created organization constituent
Create an organization relationship
Creates a new organization relationship. If the relationship is with another constituent, a reciprocal relationship is created for that constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent associated with the relationship. |
Relation ID
|
relation_id | True | string |
The system record ID of the related organization. |
Type
|
type | string |
The type of relation that the relationship represents. |
|
Reciprocal type
|
reciprocal_type | string |
Describes the constituent's relationship to the related organization. |
|
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. |
|
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 contact?
|
is_organization_contact | boolean |
Does the constituent represent this organization as a contact? |
|
Contact type
|
organization_contact_type | string |
Provides context for interactions with the related individual who represents the organization as a contact. |
|
Position
|
position | string |
The individual's position in the organization. Character limit: 50. |
|
Is primary business?
|
is_primary_business | boolean |
Is this the constituent's primary business? |
|
Notes
|
comment | string |
Additional notes about the relationship. |
Returns
Created organization relationship
Delete a constituent code
Deletes a constituent code.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent code ID
|
constituent_code_id | True | string |
The system record ID of the constituent code to delete. |
Get a constituent
Returns information about a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent to get. |
Returns
Constituent
Get a constituent by lookup ID
Returns a constituent's system record ID from the specified lookup ID.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Lookup ID
|
constituent_id | True | string |
The constituent lookup ID. |
Returns
Constituent ID map
Get a constituent profile picture
Returns the current profile picture 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 profile picture is to be retrieved. |
Returns
Profile picture
Get a constituent tribute
Returns details about a constituent tribute.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Tribute ID
|
tribute_id | True | string |
The tribute ID. |
Returns
Tribute
Get constituent name format summary
Returns the name format summary for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Name format summary
List constituent addresses
Lists the addresses 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 addresses? |
Returns
Addresses
List constituent aliases
Lists the aliases for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Aliases
List constituent attachments
Lists the attachments for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Attachments
List constituent codes
Lists the constituent codes for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Constituent codes
List constituent consent records
Lists the consent records for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Most recent only?
|
most_recent_only | boolean |
Include only the most recent consent records for each channel category combination in the response? |
Returns
Consent records
List constituent custom fields
Lists the custom fields for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Custom fields
List constituent educations
Lists the education records for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Educations
List constituent email addresses
Lists the email addresses 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 email addresses? |
Returns
Email addresses
List constituent fundraisers
Lists the fundraiser assignments 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 fundraiser assignments? |
Returns
Fundraiser assignments
List constituent memberships
Lists the memberships for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Memberships
List constituent notes
Lists the notes for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Notes
List constituent online presences
Lists the online presences 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 online presences? |
Returns
Online presences
List constituent phones
Lists the phones 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 phones? |
Returns
Phones
List constituent relationships
Lists the relationships for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
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
Relationships
List constituent solicit codes
Lists the solicit codes for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent. |
Returns
Solicit codes
List constituent tributes
Lists the tributes for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituentId | True | integer |
The system record ID of the constituent. |
Returns
Tributes
List constituents
Returns a list of constituents.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
List
|
list_id | string |
Defines a list identifier used to filter the set of constituents to those included in the specified list. If this value is set, other specified filters will be ignored. |
|
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. |
|
Constituent code
|
constituent_code | string |
Represents a constituent code to filter the list. For example, "Board Member" returns only constituents with a Board Member constituent code. |
|
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 constituent 280 or constituent 1232. |
|
Custom field category
|
custom_field_category | string |
Represents a custom field category to filter the results. For example, "Anniversary" returns only constituents with an active Anniversary custom field. |
|
Fundraiser status
|
fundraiser_status | string |
Represents a comma-separated list of fundraiser statuses to filter the results. For example, "Active,None" returns only constituents whose fundraiser status is Active or None. Valid values for this filter are Active, Inactive, and None. |
|
Include deceased?
|
include_deceased | boolean |
Include deceased constituents in the response? |
|
Include inactive?
|
include_inactive | boolean |
Include inactive constituents in the response? |
|
Postal code
|
postal_code | string |
Represents a comma-separated list of postal codes to filter the results. For example, "29466,29492" returns only constituents whose preferred address has a postal code that starts with 29466 or 29492, such as 29466, 29492, or 29492-0727. |
|
Added on or after
|
date_added | date-time |
Filter the results to constituents 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 constituents modified on or after the specified date (ex: '2020-09-18T04:13:56Z'). |
|
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,-last" sorts constituents by the "date_added" field in ascending order and then by the "last" field in descending order. |
Returns
Constituents
List fundraiser assignments
List the assignments for a fundraiser.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Fundraiser ID
|
fundraiser_id | True | string |
The system record ID of the fundraiser for whom assignments are to be returned. |
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. |
Returns
Assignments
List tribute acknowledgees
Lists the acknowledgees for a tribute.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Tribute ID
|
tributeId | True | integer |
The system record ID of the tribute. |
Returns
Tribute acknowledgees
Search for a constituent
Performs a constituent search based on the provided search text. Supports first name, last name, preferred name, former name, alias, email address, phone number, address, or lookup ID. Name combinations such as first name and last name or preferred name and last name are valid, but otherwise search only supports one parameter at a time. By default, searches include results that sound similar to your criteria. For example, searches for "Smith" include matches for "Smyth" and other alternative spellings. This search does not support wildcard characters such as * or ?. Search results are limited to 500 records.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search text
|
search_text | True | string |
The search text. Supports first name, last name, preferred name, former name, alias, email address, phone number, address, or lookup ID. Name combinations such as first name and last name or preferred name and last name are valid, but otherwise search only supports one parameter at a time. By default, searches include results that sound similar to your criteria. For example, searches for "Smith" include matches for "Smyth" and other alternative spellings. This search does not support wildcard characters such as * or ?. Search results are limited to 500 records. |
Fundraiser statuses
|
fundraiser_status | string |
Represents a comma-separated list of fundraiser statuses to filter the results. For example, "Active,None" returns only constituents whose fundraiser status is Active or None. Valid values for this filter are Active, Inactive, and None. |
|
Include inactive?
|
include_inactive | boolean |
Include inactive constituents in the response? |
|
Search field
|
search_field | string |
Represents a field to search on. Currently, it only supports lookup_id. If it is provided with search_text, a constituent with lookup_id that matches the search_text will be returned. |
|
Use strict search?
|
strict_search | boolean |
Exclude constituents whose names sound like the search text but are spelled differently? |
|
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. |
Returns
Search results
Search for a constituent (enhanced)
Searches for constituent records using the given filter criteria.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
First name
|
first_name | string |
Constituent first name. |
|
Last name
|
last_name | string |
Constituent last name. |
|
Lookup ID
|
lookup_id | string |
Constituent lookup ID. |
|
Email address
|
string |
Constituent email address. |
||
Phone number
|
phone_number | string |
Phone number. |
|
Limit
|
limit | integer |
Represents the number of records to return. The default is 500. The maximum is 1000. |
|
Address lines
|
address_lines | string |
Address lines. |
|
City
|
city | string |
Address city. |
|
State
|
state | string |
Address state. |
|
Postal code
|
post_code | string |
Address postal code. |
|
Include alias?
|
include_alias | boolean |
Include alias when searching on last name? |
|
Alias type
|
alias_type | string |
Alias type. |
|
Include maiden name?
|
include_maiden_name | boolean |
Include maiden name when searching on last name? |
Returns
Constituents
Search for duplicate constituents
Searches individual, organization, and related contact records and ranks potential duplicates based on the specified search filters. Records that match multiple filters rank higher as potential duplicates.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Last/org name
|
last_org_name | True | string |
A filter for records that match the specified last name or organization name. |
First name
|
first_name | string |
A filter for individual records that match the specified first name. |
|
Middle name
|
middle_name | string |
A filter for individual records that match the specified middle name. |
|
Suffix
|
suffix | string |
A filter for individual records that match the specified suffix. |
|
Address block
|
address_block | string |
A filter for records that match the specified address block. |
|
City
|
city | string |
A filter for records that match the specified city. |
|
State
|
state | string |
A filter for records that match the specified state. |
|
Postal code
|
post_code | string |
A filter for records that match the specified postal code. |
|
Email
|
array |
A filter for records that match the specified email addresses. |
||
Phone
|
phone | array |
A filter for records that match the specified phone numbers. |
|
Search individuals?
|
search_individuals | boolean |
Search for duplicate individual records? |
|
Search aliases?
|
search_aliases | boolean |
Search by the alias, as specified by the Last/org name parameter? |
|
Search contacts?
|
search_contacts | boolean |
Search relationship contact records? |
|
Limit
|
limit | integer |
The number of records to return when paging results (Default = 3). |
|
Offset
|
offset | integer |
The number of records to skip when paging results. |
Returns
Duplicate search results
Update a constituent
Updates a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent to update. |
Title
|
title | string |
The constituent's primary title (for individuals only). |
|
First name
|
first | string |
The constituent's first name (for individuals only). Character limit: 50. |
|
Last name
|
last | string |
The constituent's last name (for individuals only). Character limit: 100. |
|
Organization name
|
name | string |
For individuals, this is a computed field that is not applicable for edit operations. For organization, this field is required and represents the organization's name. Character limit: 100. |
|
Suffix
|
suffix | string |
The constituent's primary suffix (for individuals only). |
|
Preferred name
|
preferred_name | string |
The constituent's preferred name (for individuals only). Character limit: 50. |
|
Lookup ID
|
lookup_id | string |
The user-defined identifier for the constituent. |
|
Gender
|
gender | string |
The constituent's gender (for individuals only). |
|
Middle name
|
middle | string |
The constituent's middle name (for individuals only). Character limit: 50. |
|
Former name
|
former_name | string |
The constituent's former name (for individuals only). Character limit: 100. |
|
Title 2
|
title_2 | string |
The constituent's secondary title (for individuals only). |
|
Suffix 2
|
suffix_2 | string |
The constituent's secondary suffix (for individuals only). |
|
Marital status
|
marital_status | string |
The constituent's marital status (for individuals only). |
|
Gives anonymously?
|
gives_anonymously | boolean |
Does the constituent give anonymously? |
|
Requests no email?
|
requests_no_email | boolean |
Does the constituent request no email? |
|
Is a solicitor?
|
is_solicitor | boolean |
Is the constituent a solicitor? |
|
No valid addresses?
|
no_valid_address | boolean |
Does the constituent have no valid addresses? |
|
Inactive?
|
inactive | boolean |
Is the constituent inactive? |
|
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. |
|
Birthplace
|
birthplace | string |
The birthplace of the constituent (for individuals only). |
|
Ethnicity
|
ethnicity | string |
The ethnicity of the constituent (for individuals only). |
|
Target
|
target | string |
The target of the constituent. |
|
Income
|
income | string |
The income for the constituent (for individuals only). |
|
Receipt type
|
receipt_type | string |
The receipt type of the constituent. |
|
Religion
|
religion | string |
The religion of the constituent (for individuals only). |
|
Industry
|
industry | string |
The industry of the constituent (for organizations only). |
|
Number of employees
|
num_employees | integer |
The number of employees at the organization. |
|
Matches gifts?
|
matches_gifts | boolean |
Does the organization match gifts? |
|
Matching gift factor
|
matching_gift_factor | double |
The matching gift factor (for organizations only). |
|
Min match per gift
|
value | double |
The minimum match amount per gift for the constituent (for organizations only). |
|
Max match per gift
|
value | double |
The maximum match amount per gift for the constituent (for organizations only). |
|
Min match per constit
|
value | double |
The minimum match total for the constituent (for organizations only). |
|
Max match per constit
|
value | double |
The maximum match total for the constituent (for organizations only). |
|
Matching gift notes
|
matching_gift_notes | string |
The matching gift notes for the constituent (for organizations only). |
|
Deceased?
|
deceased | boolean |
Is the constituent deceased (for individuals only)? |
|
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 memorial?
|
is_memorial | boolean |
Is the constituent an honor/memorial? |
Update a constituent address
Updates a constituent address.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Address ID
|
address_id | True | string |
The system record ID of the address to update. |
Address type
|
type | string |
The address type. |
|
Country
|
country | string |
The country of the address (can be the ID, name, or abbreviation). |
|
Address lines
|
address_lines | string |
The address lines. |
|
City
|
city | string |
The city of the address (do not use in combination with the Suburb field). |
|
State
|
state | string |
The state of the address. |
|
Postal code
|
postal_code | string |
The postal code of the address. |
|
Suburb
|
suburb | string |
The suburb of the address (do not use in combination with the City field). |
|
County
|
county | string |
The county of the address. |
|
Information source
|
information_source | string |
The information source for the address. |
|
Region
|
region | string |
The region for the address. |
|
CART
|
cart | string |
The carrier route (CART) for the address. |
|
LOT
|
lot | string |
The line of travel (LOT) for the address. |
|
DPC
|
dpc | string |
The delivery point code (DPC) for the address. |
|
Valid from
|
start | date |
The date when the constituent began residing at this address (ex: '2005-09-18'). |
|
Valid to
|
end | date |
The date when the constituent ceased to reside at this address (ex: '2005-09-18'). |
|
Primary?
|
preferred | boolean |
Is this the constituent's preferred address? |
|
Do not mail?
|
do_not_mail | boolean |
Can the constituent be contacted at this address? |
|
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. |
|
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. |
Update a constituent alias
Updates an constituent alias.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Alias ID
|
alias_id | True | string |
The system record ID of the alias to update. |
Alias
|
name | string |
The name to use as the constituent's alias. Character limit: 100. |
|
Type
|
type | string |
The alias type. |
Update a constituent attachment
Updates a constituent 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 constituent code
Updates a constituent code.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent code ID
|
constituent_code_id | True | string |
The system record ID of the constituent code to update. |
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. |
|
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. |
|
Sequence
|
sequence | integer |
The numeric sequence associated with the constituent code. |
Update a constituent custom field
Updates a constituent 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 constituent education
Updates a constituent education.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Education ID
|
education_id | True | string |
The system record ID of the education record to update. |
School
|
school | string |
The school/establishment name. |
|
Type
|
type | string |
The type of education. |
|
Class of
|
class_of | string |
The year the constituent graduated. |
|
Status
|
status | string |
The status of the education. |
|
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. |
|
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. |
|
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. |
|
Degree
|
degree | string |
The degree received. |
|
GPA
|
gpa | double |
The grade point average. |
|
Subject of study
|
subject_of_study | string |
The subject of study. |
|
Primary?
|
primary | boolean |
Is this the constituent's primary school association? |
|
Majors
|
majors | array of string |
The major courses of study. |
|
Minors
|
minors | array of string |
The minor courses of study. |
|
Campus
|
campus | string |
The campus. Character limit: 50. |
|
Social organization
|
social_organization | string |
The social organization. Character limit: 50. |
|
Known name
|
known_name | string |
The known name. Character limit: 50. |
|
Class of degree
|
class_of_degree | string |
The class of degree. |
|
Department
|
department | string |
The name of the education department. |
|
Faculty
|
faculty | string |
The name of the faculty. |
|
Registration number
|
registration_number | string |
The registration number. Character limit: 50. |
Update a constituent email address
Updates a constituent email address.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Email address ID
|
email_address_id | True | string |
The system record ID of the email address to update. |
Email type
|
type | string |
The type of email address. |
|
Email address
|
address | string |
The email address. |
|
Primary?
|
primary | boolean |
Is this the constituent's primary email address? |
|
Do not email?
|
do_not_email | boolean |
Can the constituent be contacted at this email address? |
|
Inactive?
|
inactive | boolean |
Is this email address inactive? |
Update a constituent name format
Updates a constituent name format.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name format ID
|
name_format_id | True | string |
The system record ID of the name format to update. |
Type
|
type | string |
The name format type. |
|
Custom name format?
|
custom_format | boolean |
Is a custom format? |
|
Format
|
configuration_id | string |
Name format configuration (required unless a custom format is used). |
|
Custom name
|
formatted_name | string |
Formatted name (required when a custom format is used). Character limit: 255. |
Update a constituent note
Updates a constituent note.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Note ID
|
note_id | True | string |
The system record ID of the note to update. |
Type
|
type | string |
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: 50. |
|
Note
|
text | string |
The note text. |
Update a constituent online presence
Updates a constituent online presence.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Online presence ID
|
online_presence_id | True | string |
The system record ID of the online presence to update. |
Type
|
type | string |
The online presence type. |
|
Link
|
address | string |
The web address for the online presence. |
|
Primary?
|
primary | boolean |
Is this the constituent's primary online presence? |
|
Inactive?
|
inactive | boolean |
Is this online presence inactive? |
Update a constituent phone
Updates a constituent phone.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Phone ID
|
phone_id | True | string |
The system record ID of the phone to update. |
Type
|
type | string |
The phone type. |
|
Number
|
number | string |
The phone number. |
|
Primary?
|
primary | boolean |
Is this the constituent's primary phone? |
|
Do not call?
|
do_not_call | boolean |
Can the constituent be contacted at this number? |
|
Inactive?
|
inactive | boolean |
Is this phone number inactive? |
Update a constituent primary name format
Updates the primary name format for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name format ID
|
primary_name_format_id | True | string |
The system record ID of the primary name format to update. |
Custom name format?
|
custom_format | boolean |
Is a custom format? |
|
Format
|
configuration_id | string |
Name format configuration (required unless a custom format is used). |
|
Custom name
|
formatted_name | string |
Formatted name (required when a custom format is used). Character limit: 255. |
Update a constituent profile picture
Updates the current profile picture for a constituent.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Constituent ID
|
constituent_id | True | string |
The system record ID of the constituent whose profile picture is to be updated. |
File name
|
file_name | True | string |
The name of the file. |
Document ID
|
document_id | True | uuid |
The document identifier. |
Thumbnail ID
|
thumbnail_id | True | uuid |
The thumbnail document identifier. |
Update a constituent relationship
Updates a relationship for a constituent. If a reciprocal relationship exists, it is also modified to reflect the changes. This does not include changes to the "comments" property, which is specific to each record and can be modified independently on each record.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Relationship ID
|
relationship_id | True | string |
The system record ID of the relationship to update. |
Type
|
type | string |
The type of relation that the relationship represents. |
|
Reciprocal type
|
reciprocal_type | string |
Describes the constituent's relationship to the related constituent. For example, in a relationship between a male constituent and a female sibling, the reciprocal relationship type would be brother. |
|
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. |
|
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 spouse?
|
is_spouse | boolean |
Is the related individual the constituent's spouse (only applies to relationships between individuals)? |
|
Is constituent head of household?
|
is_constituent_head_of_household | boolean |
Is the constituent the head of the household? |
|
Is spouse head of household?
|
is_spouse_head_of_household | boolean |
Is the spouse the head of the household? |
|
Notes
|
comment | string |
Additional notes about the relationship. |
|
Is contact?
|
is_organization_contact | boolean |
Does the constituent represent this organization as a contact (only applies to relationships between organizations and individuals)? |
|
Is primary business?
|
is_primary_business | boolean |
Is this the constituent's primary business (only applies to relationships between organizations and individuals)? |
|
Contact type
|
organization_contact_type | string |
Provides context for interactions with the related individual who represents the organization as a contact. Only applies to relationships between organizations and individuals. |
|
Position
|
position | string |
The individual's position in the organization. Only applies to relationships between organizations and individuals. Character limit: 50. |
Update a constituent solicit code
Updates a constituent solicit code.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Solicit code ID
|
constituent_solicit_code_id | True | string |
The system record ID of the solicit code to update. |
Solicit code
|
solicit_code | string |
Communication instructions and/or restrictions for a constituent. |
|
Start date
|
start_date | date |
The start date of the solicit code (ex: '2005-09-18'). |
|
End date
|
end_date | date |
The end date of the solicit code (ex: '2005-09-18'). |
Definitions
CommPrefApi.ConstituentConsentRead
Represents a consent entity for a constituent.
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the consent record. |
Channel
|
channel | string |
The channel that the consent response applies to. |
Category
|
category | string |
The category that the consent response applies to. |
Source
|
source | string |
The source of the consent response from the constituent. |
Response
|
constituent_consent_response | string |
How the constituent responded to consent for the specified channel/category. |
Date
|
consent_date | date-time |
The date the consent response was received. |
Consent statement
|
consent_statement | string |
The statement the constituent responded to when providing consent. |
Privacy notice
|
privacy_notice | string |
The privacy notice provided to the constituent. |
Date added
|
date_added | date-time |
The date the consent response was added. |
Added by
|
user_name | string |
The user that added the consent response. |
CommPrefApi.ConstituentConsentReadCollection
Consent records
Name | Path | Type | Description |
---|---|---|---|
Count
|
count | integer |
The number of consent records in the list. |
value
|
value | array of CommPrefApi.ConstituentConsentRead |
The set of consent records included in the response. |
CommPrefApi.ConstituentSolicitCodeRead
Solicit code
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the constituent solicit code. |
Solicit code
|
solicit_code | string |
Communication instructions and/or restrictions for a constituent. |
Start date
|
start_date | date |
The start date of the solicit code (ex: '2005-09-18'). |
End date
|
end_date | date |
The end date of the solicit code (ex: '2005-09-18'). |
CommPrefApi.ConstituentSolicitCodeReadCollection
Solicit codes
Name | Path | Type | Description |
---|---|---|---|
Count
|
count | integer |
The number of constituent solicit codes in the list. |
value
|
value | array of CommPrefApi.ConstituentSolicitCodeRead |
The set of constituent solicit codes included in the response. |
CommPrefApi.CreatedConstituentConsent
Created constituent consent
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created consent record. |
CommPrefApi.CreatedConstituentSolicitCode
Created constituent solicit code
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent solicit code. |
ConstituentApi.AddressRead
Address
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the address. |
Type
|
type | string |
The address type. |
Country
|
country | string |
The country of the address (can be the ID, name, or abbreviation). |
Address lines
|
address_lines | string |
The address lines. |
City
|
city | string |
The city of the address (do not use in combination with the Suburb field). |
State
|
state | string |
The state of the address. |
Postal code
|
postal_code | string |
The postal code of the address. |
Suburb
|
suburb | string |
The suburb of the address (do not use in combination with the City field). |
County
|
county | string |
The county of the address. |
Formatted address
|
formatted_address | string |
The formatted address in the configured format of the country. |
Information source
|
information_source | string |
The information source for the address. |
Region
|
region | string |
The region for the address. |
CART
|
cart | string |
The carrier route (CART) for the address. |
LOT
|
lot | string |
The line of travel (LOT) for the address. |
DPC
|
dpc | string |
The delivery point code (DPC) for the address. |
Valid from
|
start | date-time |
The date when the constituent began residing at this address. |
Valid to
|
end | date-time |
The date when the constituent ceased to reside at this address. |
Primary?
|
preferred | boolean |
Is this the constituent's preferred address? |
Inactive?
|
inactive | boolean |
Is the address inactive (meaning, the current date is before any end date)? |
Do not mail?
|
do_not_mail | boolean |
Can the constituent be contacted at this address? |
day
|
seasonal_start.d | integer |
The day in the fuzzy date. |
month
|
seasonal_start.m | integer |
The month in the fuzzy date. |
year
|
seasonal_start.y | integer |
The year in the fuzzy date. |
day
|
seasonal_end.d | integer |
The day in the fuzzy date. |
month
|
seasonal_end.m | integer |
The month in the fuzzy date. |
year
|
seasonal_end.y | integer |
The year in the fuzzy date. |
Date added
|
date_added | date-time |
The date when the address was created. |
Date modified
|
date_modified | date-time |
The date when the address was last modified. |
ConstituentApi.AliasRead
Alias
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the alias. |
Alias
|
name | string |
The name to use as the constituent's alias. |
Type
|
type | string |
The alias type. |
ConstituentApi.ApiCollectionOfAddressRead
Addresses
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.AddressRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfAliasRead
Aliases
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.AliasRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfConstituentAttachmentRead
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 ConstituentApi.ConstituentAttachmentRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfConstituentCodeRead
Constituent codes
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.ConstituentCodeRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfConstituentCustomFieldRead
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 ConstituentApi.ConstituentCustomFieldRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfConstituentRead
Constituents
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.ConstituentRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfEducationRead
Educations
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.EducationRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfEmailAddressRead
Email addresses
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.EmailAddressRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfFundraiserAssignmentRead
Fundraiser assignments
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.FundraiserAssignmentRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfMembershipRead
Memberships
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.MembershipRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfNoteRead
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 ConstituentApi.NoteRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfOnlinePresenceRead
Online presences
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.OnlinePresenceRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfPhoneRead
Phones
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.PhoneRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfRelationshipRead
Relationships
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.RelationshipRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ApiCollectionOfSearchResultRead
Search results
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.SearchResultRead |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.ConstituentAttachmentRead
Attachment
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the attachment. |
Constituent ID
|
parent_id | string |
The system record ID of the constituent 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. |
ConstituentApi.ConstituentCodeRead
Constituent code
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the constituent code. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the constituent code. |
Constituent code
|
description | string |
The constituent code. |
day
|
start.d | integer |
The day in the fuzzy date. |
month
|
start.m | integer |
The month in the fuzzy date. |
year
|
start.y | integer |
The year in the fuzzy date. |
day
|
end.d | integer |
The day in the fuzzy date. |
month
|
end.m | integer |
The month in the fuzzy date. |
year
|
end.y | integer |
The year in the fuzzy date. |
Inactive?
|
inactive | boolean |
Is the constituent code inactive? |
Sequence
|
sequence | integer |
The numeric sequence associated with the constituent code. |
Date added
|
date_added | date-time |
The date when the constituent code was created. |
Date modified
|
date_modified | date-time |
The date when the constituent code was last modified. |
ConstituentApi.ConstituentCustomFieldRead
Custom field
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the custom field. |
Constituent ID
|
parent_id | string |
The system record ID of the constituent 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. |
ConstituentApi.ConstituentRead
Constituent
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID for the constituent. This is not the same as the user-definable constituent identifier, which is stored in the lookup_id. |
Type
|
type | string |
The type of constituent. |
Title
|
title | string |
The constituent's primary title (for individuals only). |
First name
|
first | string |
The constituent's first name (for individuals only). |
Last name
|
last | string |
The constituent's last name (for individuals only). |
Name
|
name | string |
For individuals, this field is the full name of the constituent based on the target organization's display name settings. For organizations, this is the organization's name. |
Preferred name
|
preferred_name | string |
The constituent's preferred name (for individuals only). |
Suffix
|
suffix | string |
The constituent's primary suffix (for individuals only). |
Lookup ID
|
lookup_id | string |
The user-defined identifier for the constituent. |
ID
|
email.id | string |
The system record ID of the email address. |
type
|
email.type | string |
The type of email address. |
address
|
email.address | string |
The email address. |
do not email?
|
email.do_not_email | boolean |
Can the constituent be contacted at this email address? |
inactive?
|
email.inactive | boolean |
Is this email address inactive? |
date added
|
email.date_added | date-time |
The date when the email address was created. |
date modified
|
email.date_modified | date-time |
The date when the email address was last modified. |
ID
|
phone.id | string |
The system record ID of the phone. |
type
|
phone.type | string |
The phone type. |
number
|
phone.number | string |
The phone number. |
do not call?
|
phone.do_not_call | boolean |
Can the constituent be contacted at this number? |
inactive?
|
phone.inactive | boolean |
Is this phone number inactive? |
date added
|
phone.date_added | date-time |
The date when the phone was created. |
date modified
|
phone.date_modified | date-time |
The date when the phone was last modified. |
ID
|
online_presence.id | string |
The system record ID of the online presence. |
type
|
online_presence.type | string |
The online presence type. |
link
|
online_presence.address | string |
The web address for the online presence. |
inactive?
|
online_presence.inactive | boolean |
Is this online presence inactive? |
date added
|
online_presence.date_added | date-time |
The date when the online presence was created. |
date modified
|
online_presence.date_modified | date-time |
The date when the online presence was last modified. |
ID
|
address.id | string |
The system record ID of the address. |
type
|
address.type | string |
The address type. |
country
|
address.country | string |
The country of the address (can be the ID, name, or abbreviation). |
lines
|
address.address_lines | string |
The address lines. |
city
|
address.city | string |
The city of the address (do not use in combination with the Suburb field). |
state
|
address.state | string |
The state of the address. |
postal code
|
address.postal_code | string |
The postal code of the address. |
suburb
|
address.suburb | string |
The suburb of the address (do not use in combination with the City field). |
county
|
address.county | string |
The county of the address. |
formatted
|
address.formatted_address | string |
The formatted address in the configured format of the country. |
valid from
|
address.start | date-time |
The date when the constituent began residing at this address. |
valid to
|
address.end | date-time |
The date when the constituent ceased to reside at this address. |
inactive?
|
address.inactive | boolean |
Is the address inactive (meaning, the current date is before any end date)? |
do not mail?
|
address.do_not_mail | boolean |
Can the constituent be contacted at this address? |
day
|
address.seasonal_start.d | integer |
The day in the fuzzy date. |
month
|
address.seasonal_start.m | integer |
The month in the fuzzy date. |
year
|
address.seasonal_start.y | integer |
The year in the fuzzy date. |
day
|
address.seasonal_end.d | integer |
The day in the fuzzy date. |
month
|
address.seasonal_end.m | integer |
The month in the fuzzy date. |
year
|
address.seasonal_end.y | integer |
The year in the fuzzy date. |
date added
|
address.date_added | date-time |
The date when the address was created. |
date modified
|
address.date_modified | date-time |
The date when the address was last modified. |
Gender
|
gender | string |
The constituent's gender (for individuals only). |
Middle name
|
middle | string |
The constituent's middle name (for individuals only). |
Former name
|
former_name | string |
The constituent's former name (for individuals only). |
Title 2
|
title_2 | string |
The constituent's secondary title (for individuals only). |
Suffix 2
|
suffix_2 | string |
The constituent's secondary suffix (for individuals only). |
Marital staus
|
marital_status | string |
The constituent's marital status (for individuals only). |
Gives anonymously?
|
gives_anonymously | boolean |
Does the constituent give anonymously? |
Requests no email?
|
requests_no_email | boolean |
Does the constituent request no email? |
Is a solicitor?
|
is_solicitor | boolean |
Is the constituent a solicitor? |
No valid addresses?
|
no_valid_address | boolean |
Does the constituent have no valid addresses? |
Inactive?
|
inactive | boolean |
Is the constituent inactive? |
day
|
birthdate.d | integer |
The day in the fuzzy date. |
month
|
birthdate.m | integer |
The month in the fuzzy date. |
year
|
birthdate.y | integer |
The year in the fuzzy date. |
Birthplace
|
birthplace | string |
The birthplace of the constituent (for individuals only). |
Ethnicity
|
ethnicity | string |
The ethnicity of the constituent (for individuals only). |
Target
|
target | string |
The target of the constituent. |
Income
|
income | string |
The income for the constituent (for individuals only). |
Receipt type
|
receipt_type | string |
The receipt type of the constituent. |
Religion
|
religion | string |
The religion of the constituent (for individuals only). |
Industry
|
industry | string |
The industry of the constituent (for organizations only). |
Number of employees
|
num_employees | integer |
The number of employees at the organization. |
Matches gifts?
|
matches_gifts | boolean |
Does the organization match gifts? |
Matching gift factor
|
matching_gift_factor | double |
The matching gift factor (for organizations only). |
value
|
matching_gift_per_gift_min.value | double |
The amount value. |
value
|
matching_gift_per_gift_max.value | double |
The amount value. |
value
|
matching_gift_total_min.value | double |
The amount value. |
value
|
matching_gift_total_max.value | double |
The amount value. |
Matching gift notes
|
matching_gift_notes | string |
The matching gift notes for the constituent (for organizations only). |
Age
|
age | integer |
The constituent's age, as calculated based on the birthdate property (for individuals only). |
Deceased?
|
deceased | boolean |
Is the constituent deceased (for individuals only)? |
day
|
deceased_date.d | integer |
The day in the fuzzy date. |
month
|
deceased_date.m | integer |
The month in the fuzzy date. |
year
|
deceased_date.y | integer |
The year in the fuzzy date. |
Fundraiser status
|
fundraiser_status | string |
Indicates whether the constituent is a fundraiser (for individuals only). |
Is memorial?
|
is_memorial | boolean |
Is the constituent an honor/memorial? |
ID
|
spouse.id | string |
The system record ID of the spouse. |
first name
|
spouse.first | string |
The spouse's first name. |
last name
|
spouse.last | string |
The spouse's last name. |
is head of household?
|
spouse.is_head_of_household | boolean |
Is the spouse the head of the household? |
Date added
|
date_added | date-time |
The date when the constituent was created. |
Date modified
|
date_modified | date-time |
The date when the constituent was last modified. |
ConstituentApi.ConvertedConstituent
Converted constituent
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the converted constituent. |
ConstituentApi.CreatedConstituentAddress
Created constituent address
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent address. |
ConstituentApi.CreatedConstituentAlias
Created constituent alias
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent alias. |
ConstituentApi.CreatedConstituentAttachment
Created constituent attachment
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent attachment. |
ConstituentApi.CreatedConstituentCode
Created constituent code
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent code. |
ConstituentApi.CreatedConstituentCustomField
Created constituent custom field
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent custom field. |
ConstituentApi.CreatedConstituentEducation
Created constituent education
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent education. |
ConstituentApi.CreatedConstituentEmailAddress
Created constituent email address
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent email address. |
ConstituentApi.CreatedConstituentNote
Created constituent note
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent note. |
ConstituentApi.CreatedConstituentOnlinePresence
Created constituent online presence
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent online presence. |
ConstituentApi.CreatedConstituentPhone
Created constituent phone
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent phone. |
ConstituentApi.CreatedIndividualConstituent
Created individual constituent
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created individual constituent. |
ConstituentApi.CreatedIndividualRelationship
Created individual relationship
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created individual relationship. |
ConstituentApi.CreatedNameFormat
Created name format
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created name format. |
ConstituentApi.CreatedOrganizationConstituent
Created organization constituent
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created organization constituent. |
ConstituentApi.CreatedOrganizationRelationship
Created organization relationship
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created organization relationship. |
ConstituentApi.DuplicateSearchResult
Duplicate search result
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID for the constituent. |
Name
|
name | string |
The constituent name. For individuals, this computed field indicates the full name of the constituent based on the target organization's display name settings. |
Display name
|
display_name | string |
The constituent's display name. |
Address
|
formatted_address | string |
The formatted primary address for the constituent. |
Deceased?
|
deceased | boolean |
Is the constituent is deceased? |
Is a constituent?
|
is_constituent | boolean |
Is the record a constituent? |
Lookup ID
|
constituent_id | string |
The user-defined identifier for the constituent. |
Date added
|
date_added | date-time |
The date the constituent was added. |
Rank
|
rank | string |
The search rank indicating what the constituent was matched on. |
ConstituentApi.DuplicateSearchResultCollection
Duplicate search results
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.DuplicateSearchResult |
The set of items included in the response. This may be a subset of the items in the collection. |
ConstituentApi.EducationRead
Education
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the education. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the education. |
School
|
school | string |
The school/establishment name. |
Type
|
type | string |
The type of education. |
Class of
|
class_of | string |
The year the constituent graduated. |
Status
|
status | string |
The status of the education. |
day
|
date_entered.d | integer |
The day in the fuzzy date. |
month
|
date_entered.m | integer |
The month in the fuzzy date. |
year
|
date_entered.y | integer |
The year in the fuzzy date. |
day
|
date_left.d | integer |
The day in the fuzzy date. |
month
|
date_left.m | integer |
The month in the fuzzy date. |
year
|
date_left.y | integer |
The year in the fuzzy date. |
day
|
date_graduated.d | integer |
The day in the fuzzy date. |
month
|
date_graduated.m | integer |
The month in the fuzzy date. |
year
|
date_graduated.y | integer |
The year in the fuzzy date. |
Degree
|
degree | string |
The degree received. |
GPA
|
gpa | double |
The grade point average. |
Majors
|
majors | array of string |
The major courses of study. |
Minors
|
minors | array of string |
The minor courses of study. |
Is primary education?
|
primary | boolean |
Is this the constituent's primary school association? |
Campus
|
campus | string |
The campus. |
Social organization
|
social_organization | string |
The social organization. |
Known name
|
known_name | string |
The known name. |
Class of degree
|
class_of_degree | string |
The class of degree. |
Department
|
department | string |
The name of the education department. |
Faculty
|
faculty | string |
The name of the faculty. |
Registration number
|
registration_number | string |
The registration number. |
Subject of study
|
subject_of_study | string |
The subject of study. |
Date added
|
date_added | date-time |
The date when the education was created. |
Date modified
|
date_modified | date-time |
The date when the education was last modified. |
ConstituentApi.EmailAddressRead
Email address
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the email address. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the email address. |
Email type
|
type | string |
The type of email address. |
Email address
|
address | string |
The email address. |
Primary?
|
primary | boolean |
Is this the constituent's primary email address? |
Do not email?
|
do_not_email | boolean |
Can the constituent be contacted at this email address? |
Inactive?
|
inactive | boolean |
Is this email address inactive? |
Date added
|
date_added | date-time |
The date when the email address was created. |
Date modified
|
date_modified | date-time |
The date when the email address was last modified. |
ConstituentApi.FundraiserAssignmentRead
Fundraiser assignment
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the fundraiser assignment. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent assigned to the fundraiser. |
Fundraiser ID
|
fundraiser_id | string |
The system record ID of the fundraiser. |
Type
|
type | string |
The type of fundraiser. |
value
|
amount.value | double |
The monetary value. |
Campaign ID
|
campaign_id | string |
The system record ID of the campaign to apply resulting gifts to. |
Fund ID
|
fund_id | string |
The system record ID of the fund any resulting gifts should be applied to. If a restricted fund is selected, only campaigns and appeals associated with that fund may be selected. |
Appeal ID
|
appeal_id | string |
The system record ID of the appeal the fundraiser should use to request gifts. |
Start date
|
start | date-time |
The fundraiser assignment start date. |
End date
|
end | date-time |
The fundraiser assignment end date. |
ConstituentApi.MembershipMemberRead
Member
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the member. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the member. |
Is primary member?
|
primary | boolean |
Is this the primary member? |
ConstituentApi.MembershipRead
Membership
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the membership. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the membership. |
Program
|
program | string |
The membership program. |
Category
|
category | string |
The membership category. |
Subcategory
|
subcategory | string |
The membership subcategory. |
Standing
|
standing | string |
The membership status. |
Expires
|
expires | date-time |
The date when the membership expires. |
Joined
|
joined | date-time |
The date when the membership becomes active. |
value
|
dues.value | double |
The monetary value. |
Members
|
members | array of ConstituentApi.MembershipMemberRead |
The set of members who belong to the membership. |
Date added
|
date_added | date-time |
The date when the membership was created. |
Date modified
|
date_modified | date-time |
The date when the membership was last modified. |
ConstituentApi.NameFormatRead
Name formats define how to address constituents in communications. How you refer to individuals sets the tone of your communications with them and how well they receive your interactions.
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the name format. |
type
|
type | string |
The name format type. |
custom format?
|
custom_format | boolean |
Is this a custom format? |
configuration ID
|
configuration_id | string |
The configuration ID of the name format (for non-custom formats). |
formatted name
|
formatted_name | string |
The formatted name (for custom formats). |
ConstituentApi.NameFormatSummaryRead
Name format summary
Name | Path | Type | Description |
---|---|---|---|
ID
|
primary_addressee.id | string |
The system record ID of the name format. |
type
|
primary_addressee.primary_type | string |
The name format type. |
custom format?
|
primary_addressee.custom_format | boolean |
Is this a custom format? |
configuration ID
|
primary_addressee.configuration_id | string |
The configuration ID of the name format (for non-custom formats). |
formatted name
|
primary_addressee.formatted_name | string |
The formatted name (for custom formats). |
ID
|
primary_salutation.id | string |
The system record ID of the name format. |
type
|
primary_salutation.primary_type | string |
The name format type. |
custom format?
|
primary_salutation.custom_format | boolean |
Is this a custom format? |
configuration ID
|
primary_salutation.configuration_id | string |
The configuration ID of the name format (for non-custom formats). |
formatted name
|
primary_salutation.formatted_name | string |
The formatted name (for custom formats). |
Additional name formats
|
additional_name_formats | array of ConstituentApi.NameFormatRead |
The additional name formats of the constituent. |
ConstituentApi.NoteRead
Note
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the note. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent 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. |
Date added
|
date_added | date-time |
The date when the note was created. |
Date modified
|
date_modified | date-time |
The date when the note was last modified. |
ConstituentApi.OnlinePresenceRead
Online presence
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the online presence. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the online presence. |
Type
|
type | string |
The online presence type. |
Link
|
address | string |
The web address for the online presence. |
Primary?
|
primary | boolean |
Is this the constituent's primary online presence? |
Inactive?
|
inactive | boolean |
Is this online presence inactive? |
Date added
|
date_added | date-time |
The date when the online presence was created. |
Date modified
|
date_modified | date-time |
The date when the online presence was last modified. |
ConstituentApi.PhoneRead
Phone
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the phone. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the phone. |
Type
|
type | string |
The phone type. |
Number
|
number | string |
The phone number. |
Primary?
|
primary | boolean |
Is this the constituent's primary phone? |
Do not call?
|
do_not_call | boolean |
Can the constituent be contacted at this number? |
Inactive?
|
inactive | boolean |
Is this phone number inactive? |
Date added
|
date_added | date-time |
The date when the phone was created. |
Date modified
|
date_modified | date-time |
The date when the phone was last modified. |
ConstituentApi.ProfilePictureRead
Profile picture
Name | Path | Type | Description |
---|---|---|---|
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the profile picture. |
URL
|
url | string |
The URL for the profile picture. The URL contains a time-bound signature that limits access to 60 minutes. |
Thumbnail URL
|
thumbnail_url | string |
The URL for a thumbnail of the profile picture. Contains a time-bound signature that limits access to 60 minutes. |
ConstituentApi.RelationshipRead
Relationship
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the relationship. |
Constituent ID
|
constituent_id | string |
The system record ID of the constituent associated with the relationship. |
Relation ID
|
relation_id | string |
The system record ID of the related individual or organization. |
Reciprocal relationship ID
|
reciprocal_relationship_id | string |
The identifier for the reciprocal relationship record. This value is read-only and is automatically generated when the relationship is created. Changes made to this record will also be reflected on the reciprocal, with the exception of the comments property. |
Name
|
name | string |
The name of the related constituent. If the related constituent is an individual, this will be the full name of the constituent based on the target organization's display name settings. |
Type
|
type | string |
The type of relation that the relationship represents. |
Reciprocal type
|
reciprocal_type | string |
Describes the constituent's relationship to the related constituent. For example, in a relationship between a male constituent and a female sibling, the reciprocal relationship type would be brother. |
day
|
start.d | integer |
The day in the fuzzy date. |
month
|
start.m | integer |
The month in the fuzzy date. |
year
|
start.y | integer |
The year in the fuzzy date. |
day
|
end.d | integer |
The day in the fuzzy date. |
month
|
end.m | integer |
The month in the fuzzy date. |
year
|
end.y | integer |
The year in the fuzzy date. |
Is spouse?
|
is_spouse | boolean |
Is the related individual the constituent's spouse (only applies to relationships between individuals)? |
Is constituent head of household?
|
is_constituent_head_of_household | boolean |
Is the constituent the head of the household? |
Is spouse head of household?
|
is_spouse_head_of_household | boolean |
Is the spouse the head of the household? |
Notes
|
comment | string |
The comment on the relationship. |
Is contact?
|
is_organization_contact | boolean |
Does the constituent represent this organization as a contact (only applies to relationships between organizations and individuals)? |
Is primary business?
|
is_primary_business | boolean |
Is this the constituent's primary business (only applies to relationships between organizations and individuals)? |
Contact type
|
organization_contact_type | string |
Provides context for interactions with the related individual who represents the organization as a contact. Only applies to relationships between organizations and individuals. |
Position
|
position | string |
The individual's position in the organization. Only applies to relationships between organizations and individuals. |
Date added
|
date_added | date-time |
The date when the relationship was created. |
Date modified
|
date_modified | date-time |
The date when the relationship was last modified. |
ConstituentApi.SearchResultRead
Search result
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the constituent. |
Name
|
name | string |
The constituent name. For individuals, this computed field indicates the full name of the constituent based on the target organization's display name settings. |
Address
|
address | string |
The constituent's preferred address. |
Deceased?
|
deceased | boolean |
Is the constituent is deceased? |
Email
|
string |
The constituent's email address. |
|
Fundraiser status
|
fundraiser_status | string |
The constituent's fundraiser status. For individuals, this computed field indicates the whether the constituent is Active, Inactive, or None. For organizations, this value will always be None. |
Inactive?
|
inactive | boolean |
Is the constituent inactive? |
Lookup ID
|
lookup_id | string |
The user-defined identifier for the constituent. |
FundraisingApi.ApiCollectionOfFundraiserAssignmentRead
Assignments
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 FundraisingApi.FundraiserAssignmentRead |
The set of items included in the response. This may be a subset of the items in the collection. |
FundraisingApi.CreatedFundraiserAssignment
Created fundraiser assignment
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created fundraiser assignment. |
FundraisingApi.FundraiserAssignmentRead
Assignment
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The system record ID of the fundraiser assignment. |
Constituent ID
|
constituent_id | string |
The system record ID of the assigned constituent. |
Type
|
type | string |
The fundraiser type. |
Assignment starts
|
start | date-time |
The start date of the assignment. |
Assignment ends
|
end | date-time |
The end date of the assignment. |
value
|
amount.value | double |
The monetary value. |
Campaign ID
|
campaign_id | string |
The system record ID of the campaign to which which resulting gifts will be applied. |
Fund ID
|
fund_id | string |
The system record ID of the fund to which which resulting gifts will be applied. |
Appeal ID
|
appeal_id | string |
The system record ID of the appeal to which which resulting gifts will be applied. |
NXTDataIntegrationApi.ConstituentIdMap
Constituent ID map
Name | Path | Type | Description |
---|---|---|---|
ID
|
system_record_id | integer |
The constituent system record ID. |
NXTDataIntegrationApi.ConstituentSearchResult
Search result
Name | Path | Type | Description |
---|---|---|---|
ID
|
record_id | integer |
The system record ID of the constituent. |
Lookup ID
|
constituent_id | string |
The constituent ID. |
Key indicator
|
key_indicator | string |
The key indicator for the record. |
First name
|
first_name | string |
The first name (individuals only). |
Last name
|
last_name | string |
The last name (individuals only). |
Middle name
|
middle_name | string |
The middle name (individuals only). |
Preferred name
|
preferred_name | string |
The preferred name (individuals only). |
Former name
|
maiden_name | string |
The former name (individuals only). |
Title 1
|
title1 | string |
The title 1 (individuals only). |
Suffix 1
|
suffix1 | string |
The suffix 1 (individuals only). |
Gender
|
gender | string |
The constituent gender (individuals only). |
day
|
birth_date.d | integer |
The day in the fuzzy date. |
month
|
birth_date.m | integer |
The month in the fuzzy date. |
year
|
birth_date.y | integer |
The year in the fuzzy date. |
Spouse first name
|
spouse_first_name | string |
The spouse's first name (individuals only). |
Spouse last name
|
spouse_last_name | string |
The spouse's last name (individuals only). |
Organization name
|
org_name | string |
The organization name (organizations only). |
Address block
|
address_block | string |
The address block. |
City and state
|
address_city_state | string |
The address city and state. |
Postal code
|
address_post_code | string |
The address post code. |
Primary email address
|
primary_email | string |
The primary email. |
Primary phone number
|
primary_phone | string |
The primary phone. |
Matched alias
|
matched_alias | string |
The matched alias name (individuals only). |
Matched email
|
matched_email | string |
The matched email address. |
Matched phone
|
matched_phone | string |
The matched phone number. |
Is a constituent?
|
is_constituent | boolean |
Is the record a constituent? |
Is deceased?
|
is_deceased | boolean |
Is the record deceased? |
Is inactive?
|
is_inactive | boolean |
Is the record inactive? |
NXTDataIntegrationApi.ConstituentSearchResultCollection
Constituents
Name | Path | Type | Description |
---|---|---|---|
results
|
results | array of NXTDataIntegrationApi.ConstituentSearchResult |
The set of items included in the response. This may be a subset of the items in the collection. |
NXTDataIntegrationApi.CreatedConstituentTribute
Created constituent tribute
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created constituent tribute. |
NXTDataIntegrationApi.CreatedTributeAcknowledgee
Created tribute acknowledgee
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | string |
The ID of the newly created tribute acknowledgee. |
NXTDataIntegrationApi.Tribute
Tribute
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer |
The system record ID of the tribute. |
Constituent ID
|
constituent_record_id | integer |
The system record ID of the constituent associated with the tribute. |
Tribute type
|
tribute_type_name | string |
The tribute type. |
Tribute type ID
|
tribute_type_id | integer |
The tribute type ID. |
Description
|
description | string |
The tribute description. |
day
|
start_date.d | integer |
The day in the fuzzy date. |
month
|
start_date.m | integer |
The month in the fuzzy date. |
year
|
start_date.y | integer |
The year in the fuzzy date. |
day
|
end_date.d | integer |
The day in the fuzzy date. |
month
|
end_date.m | integer |
The month in the fuzzy date. |
year
|
end_date.y | integer |
The year in the fuzzy date. |
Default fund ID
|
default_fund_id | integer |
The system record ID of the default fund associated with the tribute. |
Notes
|
notes | string |
The tribute notes. |
Active?
|
is_active | boolean |
Is this tribute active? |
Sequence
|
sequence | integer |
The tribute sequence. |
Date added
|
date_added | date-time |
The date when the tribute was created. |
Date modified
|
date_modified | date-time |
The date when the tribute was last modified. |
NXTDataIntegrationApi.TributeAcknowledgee
Tribute acknowledgee
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer |
The system record ID of the tribute acknowledgee. |
Tribute ID
|
tribute_id | integer |
The system record ID of the tribute associated with the acknowledgee. |
Relationship ID
|
relationships_id | integer |
The system record ID of the relationship (if null, this represents a self-acknowledgee). |
Letter ID
|
letter | integer |
The letter ID. |
Sequence
|
sequence | integer |
The tribute acknowledgee sequence. |
NXTDataIntegrationApi.TributeAcknowledgeeCollection
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.TributeAcknowledgee |
The set of items included in the response. This may be a subset of the items in the collection. |
NXTDataIntegrationApi.TributeCollection
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.Tribute |
The set of items included in the response. This may be a subset of the items in the collection. |