Fundraising (Beta)

Monitor this page to keep up with the Fundraising API (Beta) latest changes and SKY API service releases.

2018-06-19

New

Added the following endpoints:

Operation Method Route
Package list GET /packages

2018-06-01

Announcement: Changes for Fundraising (Beta) API

We implemented new operation ID values in the OpenApi (fka Swagger) definitions for all endpoints in the Fundraising API. Note that any existing code relying on these endpoints will continue to function, since all routes and parameters are unchanged. However, if you make use of client-side generated code and want to regenerate your client wrapper, compile-time errors in your code stemming from new operation ID values will arise and need to be addressed.

New

Added the following endpoint:

Operation Method Route
Document (Create) POST /documents

May

2018-05-25

Announcement: Changes Planned for Constituent, Fundraising (Beta), Gift (Beta), and Opportunity (Beta) APIs

We will implement new operation ID values in the OpenApi (fka Swagger) definitions for several SKY APIs. This change will improve client-side tooling support for code generation by making these values more deterministic and friendlier across different languages. Going forward, we expect high stability of these values (meaning, we won’t need to change them again).

Note that any existing code that has been deployed will continue to function with no problems, since we are not changing any routes or parameters. If you make use of client-side generated code and want to regenerate your client wrapper, you’ll need to fix any compile-time errors in your code stemming from new method names.

April

2018-04-19

New

Added the following endpoints:

Operation Method Route
Fundraiser assignment list (Single fundraiser) GET /fundraisers/{fundraiser_id}/assignments
Fundraiser assignment (Create) POST /fundraisers/assignments
Fundraiser assignment (Edit) PATCH /fundraisers/assignments/{assignment_id}
Fundraiser assignment (Delete) DELETE /fundraisers/assignments/{assignment_id}
Fundraiser types GET /fundraisers/types

February

2018-02-27

New

Added the following endpoints:

Operation Method Route
Fundraiser goal list (Single constituent) GET /fundraisers/{fundraiser_id}goals
Fundraiser goal (Create) POST /fundraisers/goals
Fundraiser goal (Edit) PATCH /fundraisers/goals/{goal_id}
Fundraiser goal (Delete) DELETE /fundraisers/goals/{goal_id}
Appeal categories GET /appeals/categories
Campaign categories GET /campaigns/categories
Fund categories GET /funds/categories

Changed

We changed the URL for the Goal categories (Get) endpoint to /fundraisers/goals/categories as previously announced.

2018-02-09

Announcement: Breaking Changes Planned for Fundraising API (Beta)

We will change the URL for the Goal categories (Get) endpoint to /fundraisers/goals/categories.

2018-02-05

Changed

We added the type property to the fund entity.

January

2018-01-29

New

Added the following endpoint:

Operation Method Route
Attachment tags GET /attachmenttags

Changed

2017

2017-12-15

New

Added the following endpoints:

Operation Method Route
Goal categories GET /fundraising/goalcategories
Package GET /packages/{package_id}

2017-08-28

New

Added the following endpoints:

Operation Method Route
Appeal attachment list (Single appeal) GET /appeals/{appeal_id}/attachments
Appeal attachment (Create) POST /appeals/attachments
Appeal attachment (Edit) PATCH /appeals/attachments/{attachment_id}
Appeal attachment (Delete) DELETE /appeals/attachments/{attachment_id}
Campaign attachment list (Single campaign) GET /campaigns/{campaign_id}/attachments
Campaign attachment (Create) POST /campaigns/attachments
Campaign attachment (Edit) PATCH /campaigns/attachments/{attachment_id}
Campaign attachment (Delete) DELETE /campaigns/attachments/{attachment_id}
Fund attachment list (Single fund) GET /funds/{fund_id}/attachments
Fund attachment (Create) POST /funds/attachments
Fund attachment (Edit) PATCH /funds/attachments/{attachment_id}
Fund attachment (Delete) DELETE /funds/attachments/{attachment_id}

2017-05-09

Changed

The Appeal list, Campaign list, and Fund list endpoints now exclude inactive records by default. To include inactive records, set the include_inactive parameter to true.

2017-04-28

Announcement: Breaking Changes Planned for Fundraising API (Beta)

We will update the default value of the include_inactive filter to false on the Appeal list, Campaign list, and Fund list endpoints to exclude inactive records by default. Currently, the filter defaults to true and includes inactive records when no value is supplied.

2017-04-06

New

Added the following endpoints:

Operation Method Route
Appeal list GET /appeals
Campaign list GET /campaigns
Fund list GET /funds

2017-03-08

New

The Fundraising API has been released for a public beta. This API handles information related to the fundraising hierarchy, including the campaign, fund, and appeal entities:

  • Campaigns set the overall objectives and initiatives for raising money, and they are typically the top tier of the fundraising hierarchy. For example, organizations can create campaigns to encompass fundraising efforts related to annual operating expenses, new buildings, or endowments.
  • Funds represent the donor's intent for how to use or earmark a gift. For example, the gift can be intended for a specific cause or financial purpose. Funds are often linked to financial suites and indicate where to allocate a gift.
  • Appeals are the sources and solicitations that bring in gifts, and they are typically the most granular piece of the fundraising hierarchy. Examples of appeals include direct mailings, online donation pages, phonathons, auctions, and events.

The initial release contains endpoints to retrieve these entities by ID and to manage custom fields. For more information, see the entity and endpoint references.