# Blackbaud

> Work with Blackbaud Raiser's Edge NXT: find, add and update constituents, record gifts, log actions and notes, and start workflows when constituents, gifts or actions are added or changed.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/blackbaud

## Actions

### Add address

Add a postal address to a constituent, optionally as their preferred one.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- Address type (`address_type`, text, required): Its type, such as Home or Business.
- Street address (`address_lines`, text, required): The street lines.
- City (`city`, text): City.
- State (`state`, text): State or province, such as SC.
- Postal code (`postal_code`, text): ZIP or postal code.
- Country (`country`, text): Country name or abbreviation. Defaults to your organization's.
- Make preferred (`preferred`, true/false): Make it their preferred address.

**Outputs**

- `address_id` (text): The new address record's id
- `constituent_id` (text): The constituent's id

**Example output**

```json
{
  "address_id": "3002",
  "constituent_id": "280"
}
```

### Add email address

Add an email address to a constituent, optionally as their primary one.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- Email address (`address`, text, required): The email address.
- Email type (`email_type`, text, required): Its type, such as Email.
- Make primary (`primary`, true/false): Make it their primary email address.
- Do not email (`do_not_email`, true/false): They asked not to be emailed here.

**Outputs**

- `constituent_id` (text): The constituent's id
- `email_address_id` (text): The new email address record's id

**Example output**

```json
{
  "constituent_id": "280",
  "email_address_id": "1002"
}
```

### Add note

Add a note to a constituent's record.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- Note type (`note_type`, text, required): The type from your Notepad Types table.
- Date (`note_date`, date): The note's date. Defaults to today.
- Summary (`summary`, text): A short summary, up to 255 characters.
- Text (`text`, text): What the note says.

**Outputs**

- `constituent_id` (text): The constituent's id
- `note_id` (text): The new note's id

**Example output**

```json
{
  "constituent_id": "280",
  "note_id": "4001"
}
```

### Add phone number

Add a phone number to a constituent, optionally as their primary one.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- Phone number (`number`, text, required): The phone number.
- Phone type (`phone_type`, text, required): Its type, such as Home or Mobile.
- Make primary (`primary`, true/false): Make it their primary phone number.
- Do not call (`do_not_call`, true/false): They asked not to be called here.

**Outputs**

- `constituent_id` (text): The constituent's id
- `phone_id` (text): The new phone record's id

**Example output**

```json
{
  "constituent_id": "280",
  "phone_id": "2002"
}
```

### Create action

Log a phone call, meeting, mailing, email or task with a constituent.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- Category (`category`, text, required): What kind of action it is. One of: `Phone Call`, `Meeting`, `Mailing`, `Email`, `Task/Other` (Task or other).
- Date (`action_date`, date): The day of the action. Defaults to today.
- Summary (`summary`, text): A short summary, up to 255 characters.
- Description (`description`, text): The details.
- Action type (`action_type`, text): The type from your Actions table.
- Status (`status`, text): The status, if your organization uses custom action statuses.
- Priority (`priority`, text): How important it is. One of: `Normal` (Normal (default)), `High`, `Low`.
- Direction (`direction`, text): Who reached out. One of: `Outbound` (Outbound (we reached out)), `Inbound` (Inbound (they reached out)).
- Outcome (`outcome`, text): How it went. One of: `Successful`, `Unsuccessful`.
- Start time (`start_time`, time): When it starts.
- End time (`end_time`, time): When it ends.
- Location (`location`, text): Where it happens.
- Completed (`completed`, true/false): Mark it done.

**Outputs**

- `action_id` (text): The new action's system record id
- `constituent_id` (text): The constituent's id

**Example output**

```json
{
  "action_id": "5012",
  "constituent_id": "280"
}
```

### Create constituent

Add a person or organization to Raiser's Edge NXT, with a primary email, phone and address if you give them.

**Inputs**

- Type (`constituent_type`, text, required): A person or an organization. One of: `Individual` (Individual (a person)), `Organization`.
- First name (`first`, text): First name, for an individual.
- Last name (`last`, text): Last name. Required for a new individual.
- Organization name (`organization_name`, text): The organization's name. Required for a new organization.
- Preferred name (`preferred_name`, text): The name they like to be called.
- Title (`title`, text): Their title, such as Dr. or Ms.
- Gender (`gender`, text): Their gender, as your Gender table lists it.
- Birthdate (`birthdate`, date): Their date of birth, for an individual.
- Lookup ID (`lookup_id`, text): Your organization's own id for the constituent.
- Email (`email`, text): Their primary email address.
- Email type (`email_type`, text): The email's type, such as Email. Required with an email.
- Phone (`phone`, text): Their primary phone number.
- Phone type (`phone_type`, text): The phone's type, such as Home or Mobile. Required with a phone.
- Street address (`address_lines`, text): The street lines.
- City (`city`, text): City.
- State (`state`, text): State or province, such as SC.
- Postal code (`postal_code`, text): ZIP or postal code.
- Country (`country`, text): Country name or abbreviation. Defaults to your organization's.
- Address type (`address_type`, text): The address's type, such as Home. Required with an address.

**Outputs**

- `constituent_id` (text): The new constituent's system record id

**Example output**

```json
{
  "constituent_id": "1281"
}
```

### Delete action

Delete an action from a constituent's record.

**Inputs**

- Action ID (`action_id`, text, required): The action's system record id, from 'List actions' or an earlier step.

**Outputs**

- `action_id` (text): The deleted action's id
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "action_id": "5011",
  "deleted": true
}
```

### Delete constituent

Delete a constituent record from Raiser's Edge NXT. This can't be undone.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.

**Outputs**

- `constituent_id` (text): The deleted constituent's id
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "constituent_id": "280",
  "deleted": true
}
```

### Delete gift

Delete a gift. Blackbaud refuses gifts that can't be deleted, such as posted ones.

**Inputs**

- Gift ID (`gift_id`, text, required): The gift's system record id, from 'List gifts' or an earlier step.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `gift_id` (text): The deleted gift's id

**Example output**

```json
{
  "deleted": true,
  "gift_id": "773"
}
```

### Get constituent

Get one constituent: name, type, status, birthdate, and their primary email, phone and preferred address.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.

**Outputs**

- `constituent` (object): A constituent: a person or organization in Raiser's Edge NXT

**Example output**

```json
{
  "constituent": {
    "address": {
      "address_lines": "65 Fairchild Street",
      "city": "Charleston",
      "country": "United States",
      "do_not_mail": false,
      "formatted_address": "65 Fairchild Street\r\nCharleston, SC 29492",
      "id": "3001",
      "postal_code": "29492",
      "preferred": true,
      "state": "SC",
      "type": "Home"
    },
    "age": 46,
    "birthdate": {
      "d": 2,
      "m": 4,
      "y": 1980
    },
    "date_added": "2026-11-01T14:03:00.000-04:00",
    "date_modified": "2026-11-05T09:12:00.000-05:00",
    "deceased": false,
    "email": {
      "address": "jo@example.org",
      "do_not_email": false,
      "id": "1001",
      "inactive": false,
      "primary": true,
      "type": "Email"
    },
    "first": "Jo",
    "fundraiser_status": "None",
    "gender": "Female",
    "gives_anonymously": false,
    "id": "280",
    "inactive": false,
    "last": "Bloggs",
    "lookup_id": "96",
    "middle": "",
    "name": "Jo Bloggs",
    "phone": {
      "do_not_call": false,
      "id": "2001",
      "inactive": false,
      "number": "(843) 555-0100",
      "primary": true,
      "type": "Home"
    },
    "preferred_name": "Jo",
    "title": "Ms.",
    "type": "Individual"
  }
}
```

### Get gift

Get one gift: amount, date, donor, type, status, fund split and payment.

**Inputs**

- Gift ID (`gift_id`, text, required): The gift's system record id, from 'List gifts' or an earlier step.

**Outputs**

- `gift` (object): A gift recorded in Raiser's Edge NXT

**Example output**

```json
{
  "gift": {
    "amount": {
      "value": 50.0
    },
    "balance": {
      "value": 0.0
    },
    "constituency": "Individual",
    "constituent_id": "280",
    "date": "2026-11-05T00:00:00",
    "date_added": "2026-11-05T10:00:00.000-05:00",
    "date_modified": "2026-11-05T10:00:00.000-05:00",
    "gift_splits": [
      {
        "amount": {
          "value": 50.0
        },
        "appeal_id": "15",
        "campaign_id": "1",
        "fund_id": "41",
        "id": "801",
        "package_id": ""
      }
    ],
    "gift_status": "Active",
    "id": "773",
    "is_anonymous": false,
    "lookup_id": "1501",
    "payments": [
      {
        "check_number": "",
        "payment_method": "Cash",
        "reference": ""
      }
    ],
    "post_date": "2026-11-05T00:00:00",
    "post_status": "NotPosted",
    "reference": "Year-end appeal reply",
    "subtype": "",
    "type": "Donation"
  }
}
```

### List actions

List actions (calls, meetings, mailings, emails and tasks), for every constituent or all of one constituent's.

**Inputs**

- Constituent ID (`constituent_id`, text): Only this constituent's actions. Lists them all at once, so leave the other filters empty.
- Status (`computed_status`, text): Only open, completed or past-due actions. One of: `Open`, `Completed`, `PastDue` (Past due).
- Added on or after (`added_since`, date): Only records added on or after this day.
- Changed on or after (`changed_since`, date): Only records changed on or after this day.
- How many (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.
- Next page (`next_page`, text): The 'next_page' an earlier run of this step gave, to get the page after it.

**Outputs**

- `actions` (list): The actions
- `count` (number): How many records match in all, across every page
- `next_page` (text): Give this to the same step's Next page field for the next page; empty on the last page

**Example output**

```json
{
  "actions": [
    {
      "category": "Phone Call",
      "completed": true,
      "completed_date": "2026-11-05T00:00:00",
      "computed_status": "Completed",
      "constituent_id": "280",
      "date": "2026-11-05T00:00:00",
      "date_added": "2026-11-05T15:00:00.000-05:00",
      "date_modified": "2026-11-05T15:00:00.000-05:00",
      "description": "",
      "direction": "Outbound",
      "end_time": "14:45",
      "fundraisers": [
        "187"
      ],
      "id": "5011",
      "location": "",
      "outcome": "Successful",
      "priority": "Normal",
      "start_time": "14:30",
      "status": "Completed",
      "summary": "Thanked Jo for her gift",
      "type": "Thank you call"
    }
  ],
  "count": 1,
  "next_page": ""
}
```

### List code table entries

List the values one of your Raiser's Edge NXT tables allows, such as phone types or note types, to use in other steps.

**Inputs**

- Table (`table`, text, required): Which table to read. One of: `address_types` (Address types), `email_types` (Email types), `phone_types` (Phone types), `note_types` (Note types), `action_types` (Action types), `action_statuses` (Action statuses), `action_locations` (Action locations), `titles`, `genders`, `gift_subtypes` (Gift subtypes).

**Outputs**

- `count` (number): How many entries there are
- `entries` (list): The table's active entries
- `table` (text): The table that was read

**Example output**

```json
{
  "count": 3,
  "entries": [
    "Home",
    "Mobile",
    "Business"
  ],
  "table": "phone_types"
}
```

### List constituents

List constituents with their primary email, phone and address, optionally only those added or changed since a day.

**Inputs**

- Added on or after (`added_since`, date): Only records added on or after this day.
- Changed on or after (`changed_since`, date): Only records changed on or after this day.
- Include inactive (`include_inactive`, true/false): Also include records marked inactive.
- Include deceased (`include_deceased`, true/false): Also include people who have died.
- How many (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.
- Next page (`next_page`, text): The 'next_page' an earlier run of this step gave, to get the page after it.

**Outputs**

- `constituents` (list): The constituents
- `count` (number): How many records match in all, across every page
- `next_page` (text): Give this to the same step's Next page field for the next page; empty on the last page

**Example output**

```json
{
  "constituents": [
    {
      "address": {
        "address_lines": "65 Fairchild Street",
        "city": "Charleston",
        "country": "United States",
        "do_not_mail": false,
        "formatted_address": "65 Fairchild Street\r\nCharleston, SC 29492",
        "id": "3001",
        "postal_code": "29492",
        "preferred": true,
        "state": "SC",
        "type": "Home"
      },
      "age": 46,
      "birthdate": {
        "d": 2,
        "m": 4,
        "y": 1980
      },
      "date_added": "2026-11-01T14:03:00.000-04:00",
      "date_modified": "2026-11-05T09:12:00.000-05:00",
      "deceased": false,
      "email": {
        "address": "jo@example.org",
        "do_not_email": false,
        "id": "1001",
        "inactive": false,
        "primary": true,
        "type": "Email"
      },
      "first": "Jo",
      "fundraiser_status": "None",
      "gender": "Female",
      "gives_anonymously": false,
      "id": "280",
      "inactive": false,
      "last": "Bloggs",
      "lookup_id": "96",
      "middle": "",
      "name": "Jo Bloggs",
      "phone": {
        "do_not_call": false,
        "id": "2001",
        "inactive": false,
        "number": "(843) 555-0100",
        "primary": true,
        "type": "Home"
      },
      "preferred_name": "Jo",
      "title": "Ms.",
      "type": "Individual"
    }
  ],
  "count": 1,
  "next_page": ""
}
```

### List funds, campaigns or appeals

List your funds, campaigns or appeals with their ids, the records gifts are credited to. Active ones only unless you include inactive.

**Inputs**

- Which (`record_type`, text): Funds, campaigns or appeals. Defaults to funds. One of: `funds` (Funds (default)), `campaigns`, `appeals`.
- Include inactive (`include_inactive`, true/false): Also include records marked inactive.
- How many (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.
- Next page (`next_page`, text): The 'next_page' an earlier run of this step gave, to get the page after it.

**Outputs**

- `count` (number): How many records match in all, across every page
- `next_page` (text): Give this to the same step's Next page field for the next page; empty on the last page
- `record_type` (text): funds, campaigns or appeals
- `records` (list): The funds, campaigns or appeals

**Example output**

```json
{
  "count": 1,
  "next_page": "",
  "record_type": "funds",
  "records": [
    {
      "category": "Unrestricted",
      "description": "General Fund",
      "end_date": "2026-12-31T00:00:00",
      "goal": {
        "value": 100000.0
      },
      "id": "41",
      "inactive": false,
      "lookup_id": "GEN",
      "start_date": "2026-01-01T00:00:00"
    }
  ]
}
```

### List gifts

List gifts, by donor, gift type, fund, campaign, appeal, gift date or when they were added or changed.

**Inputs**

- Constituent ID (`constituent_id`, text): Only this donor's gifts: their system record id.
- Gift types (`gift_types`, list): Only gifts of these types. One or more of: `Donation`, `GiftInKind` (Gift in kind), `Other`, `Pledge`, `PledgePayment` (Pledge payment), `RecurringGift` (Recurring gift), `RecurringGiftPayment` (Recurring gift payment), `MatchingGiftPledge` (Matching gift pledge), `MatchingGiftPayment` (Matching gift payment), `Stock`.
- Fund (`fund_id`, text): Only gifts to this fund.
- Campaign (`campaign_id`, text): Only gifts to this campaign.
- Appeal (`appeal_id`, text): Only gifts from this appeal.
- Gift date from (`from_date`, date): Only gifts dated on or after this day.
- Gift date to (`to_date`, date): Only gifts dated on or before this day.
- Added on or after (`added_since`, date): Only records added on or after this day.
- Changed on or after (`changed_since`, date): Only records changed on or after this day.
- How many (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.
- Next page (`next_page`, text): The 'next_page' an earlier run of this step gave, to get the page after it.

**Outputs**

- `count` (number): How many records match in all, across every page
- `gifts` (list): The gifts
- `next_page` (text): Give this to the same step's Next page field for the next page; empty on the last page

**Example output**

```json
{
  "count": 1,
  "gifts": [
    {
      "amount": {
        "value": 50.0
      },
      "balance": {
        "value": 0.0
      },
      "constituency": "Individual",
      "constituent_id": "280",
      "date": "2026-11-05T00:00:00",
      "date_added": "2026-11-05T10:00:00.000-05:00",
      "date_modified": "2026-11-05T10:00:00.000-05:00",
      "gift_splits": [
        {
          "amount": {
            "value": 50.0
          },
          "appeal_id": "15",
          "campaign_id": "1",
          "fund_id": "41",
          "id": "801",
          "package_id": ""
        }
      ],
      "gift_status": "Active",
      "id": "773",
      "is_anonymous": false,
      "lookup_id": "1501",
      "payments": [
        {
          "check_number": "",
          "payment_method": "Cash",
          "reference": ""
        }
      ],
      "post_date": "2026-11-05T00:00:00",
      "post_status": "NotPosted",
      "reference": "Year-end appeal reply",
      "subtype": "",
      "type": "Donation"
    }
  ],
  "next_page": ""
}
```

### Record gift

Record a one-off gift from a constituent to a fund, paid by cash, check, PayPal, Venmo or another method.

**Inputs**

- Donor (`constituent_id`, text, required): The donor's constituent system record id.
- Amount (`amount`, number, required): The gift's amount, such as 50 or 25.50. At least 0.01.
- Gift date (`gift_date`, date): The day of the gift. Defaults to today.
- Fund (`fund_id`, text, required): The fund the gift goes to.
- Campaign (`campaign_id`, text): The campaign it counts towards.
- Appeal (`appeal_id`, text): The appeal it answers.
- Gift type (`gift_type`, text): The kind of gift. One of: `Donation` (Donation (default)), `GiftInKind` (Gift in kind), `Other`.
- Payment method (`payment_method`, text): How it was paid. One of: `Cash` (Cash (default)), `PersonalCheck` (Check), `Other`, `PayPal`, `Venmo`.
- Check number (`check_number`, text): The check number, for a check.
- Reference (`reference`, text): Notes about the gift, up to 255 characters.
- Lookup ID (`lookup_id`, text): Your organization's own id for the gift.
- Post status (`post_status`, text): Whether it will be posted to the general ledger. One of: `NotPosted` (Not posted yet (default)), `DoNotPost` (Do not post).
- Anonymous (`is_anonymous`, true/false): Record the gift as anonymous.

**Outputs**

- `constituent_id` (text): The donor's id
- `gift_id` (text): The new gift's system record id

**Example output**

```json
{
  "constituent_id": "280",
  "gift_id": "1281"
}
```

### Search constituents

Find constituents by name, email address, phone number, address or lookup ID. Names that sound alike match too unless you ask for exact.

**Inputs**

- Search for (`search_text`, text, required): What to look for, such as Jo Bloggs or jo@example.org.
- Search in (`search_field`, text): Where to look. Defaults to names, emails, phones and addresses. One of: `name` (Name, email, phone or address (default)), `lookup_id` (Lookup ID), `email_address` (Email address only).
- Include inactive (`include_inactive`, true/false): Also include records marked inactive.
- Exact spelling only (`strict_search`, true/false): Leave out names that only sound like the search.
- How many (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.

**Outputs**

- `constituents` (list): The constituents found
- `count` (number): How many records match in all, across every page
- `next_page` (text): Give this to the same step's Next page field for the next page; empty on the last page

**Example output**

```json
{
  "constituents": [
    {
      "address": "65 Fairchild Street\r\nCharleston, SC 29492",
      "deceased": false,
      "email": "jo@example.org",
      "fundraiser_status": "None",
      "id": "280",
      "inactive": false,
      "lookup_id": "96",
      "name": "Jo Bloggs"
    }
  ],
  "count": 1,
  "next_page": ""
}
```

### Update action

Change an action's details or mark it done. Fields left empty keep their values.

**Inputs**

- Action ID (`action_id`, text, required): The action's system record id, from 'List actions' or an earlier step.
- Category (`category`, text): A new category. One of: `Phone Call`, `Meeting`, `Mailing`, `Email`, `Task/Other` (Task or other).
- Date (`action_date`, date): The day of the action. Defaults to today.
- Summary (`summary`, text): A short summary, up to 255 characters.
- Description (`description`, text): The details.
- Action type (`action_type`, text): The type from your Actions table.
- Status (`status`, text): The status, if your organization uses custom action statuses.
- Priority (`priority`, text): How important it is. One of: `Normal` (Normal (default)), `High`, `Low`.
- Direction (`direction`, text): Who reached out. One of: `Outbound` (Outbound (we reached out)), `Inbound` (Inbound (they reached out)).
- Outcome (`outcome`, text): How it went. One of: `Successful`, `Unsuccessful`.
- Start time (`start_time`, time): When it starts.
- End time (`end_time`, time): When it ends.
- Location (`location`, text): Where it happens.
- Completed (`completed`, text): Mark it done or not done. Leave empty to keep it. One of: `yes`, `no`.

**Outputs**

- `action_id` (text): The action's id
- `updated_fields` (list): The fields that were changed

**Example output**

```json
{
  "action_id": "5011",
  "updated_fields": [
    "completed",
    "completed_date"
  ]
}
```

### Update constituent

Change a constituent's name, title, gender, birthdate, lookup ID or status. Fields left empty keep their values.

**Inputs**

- Constituent ID (`constituent_id`, text, required): The constituent's system record id, from 'Search constituents' or an earlier step.
- First name (`first`, text): First name, for an individual.
- Last name (`last`, text): Last name. Required for a new individual.
- Organization name (`organization_name`, text): The organization's name. Required for a new organization.
- Preferred name (`preferred_name`, text): The name they like to be called.
- Title (`title`, text): Their title, such as Dr. or Ms.
- Gender (`gender`, text): Their gender, as your Gender table lists it.
- Birthdate (`birthdate`, date): Their date of birth, for an individual.
- Lookup ID (`lookup_id`, text): Your organization's own id for the constituent.
- Status (`status`, text): Mark the record active or inactive. Leave empty to keep it. One of: `active`, `inactive`.

**Outputs**

- `constituent_id` (text): The constituent's system record id
- `updated_fields` (list): The fields that were changed

**Example output**

```json
{
  "constituent_id": "280",
  "updated_fields": [
    "preferred_name"
  ]
}
```
