The General Ledger API was updated on 10/23/2018. See our  Changelog  entries for more information. We discovered and resolved an issue with the Account (GET) endpoint. We also added the new  Project attachment  endpoint. more

The Accounts Payable API was updated on 09/25/2018. See our  Changelog  entries for more information. We added the new Configuration and Purchase order endpoints . We also changed the Vendor (List) endpoint to resolve an issue where vendors with payment_method of EFT were being returned as Check .   more

The Communication Preference API (Beta) was released for a public beta on 9/24/2018. This API manages constituent communication preference information and related entities such as constituent consent. See the  changelog  for more information.   more

We have migrated all APIs from the SKY API Status page to the Blackbaud Status Page . We have also updated the status page link in the SKY API Developer Portal to the new Status Page location . We have nested the SKY APIs within existing products on the Blackbaud Status page.  The order and placement of the APIs may change in the future.  To ... more

We are aware of an issue with the Project (Search) endpoint.  account_restrictions  are not being set properly. We are working to resolve this issue and will post an update as soon as it is available. Resolved: For the issue reported on 2018-08-16,  account_restrictions  are information are now correct. more

We are aware of an issue with the Account (Search) endpoint:   prevent_data_entry ,   prevent_posting_date , and  custom_fields  are not being set properly.  We are working to resolve this issue and will post an update as soon as it is available. Resolved: For the issue reported on 2018-08-15, prevent_data_entry ,   prevent_posting_date , and  ... more

The General Ledger API was updated on 08/14/2018. See our Changelog entries for more information. We added the new  Journal entry (Edit)  endpoint. more

The Treasury (Beta) API was updated on 08/14/2018. See our  Changelog  entries for more information. We added the new  Cash receipt , Treasury Media Type (List) , and  Cash receipt attachment  endpoints.  more

The General Ledger API was updated on 08/3/2018. See our  Changelog  entries for more information. We added the following new endpoints: Cash management distribution set (List) - GET Cash management distribution set  - GET Cash management distribution set  - POST Cash management distribution set  - PATCH Cash management distribution set  - ... more

The General Ledger API was updated on 07/19/2018. See our  Changelog  entries for more information. We added the new Budget detail , Budget , and Budget detail lines (list) endpoints. We also edited the Journal entry batch attachment endpoint. more

The Accounts Payable API was updated on 07/19/2018. See our  Changelog  entries for more information. We added the new Vendor attachment endpoint . more

We have transitioned the  Fundraising , Gift , Opportunity , and Treasury  APIs out of their public beta phase and into formal v1 releases. more

The Constituent API was updated on 7/3/2018. See our  Changelog  entries for more information. We added the Membership list (All constituent) endpoint, and we added new query parameters to the Constituent list, Constituent (Search), and Action list (All constituents) endpoints. more

The Accounts Payable API was updated on 06/28/2018. See our  Changelog  entries for more information. We added the new  Transaction code (List) and Transaction code value (List)  endpoints.  more

The General Ledger API was updated on 06/28/2018. See our  Changelog  entries for more information. We added the new  Journal entry batch summary  and  Journal entries (List)  endpoints. These endpoints resolve the 06/07/2018 known issue for the Journal entry batch (GET) endpoint. The  Journal entry batch (GET) endpoint has been deprecated. more

The Treasury (Beta) API was updated on 06/28/2018. See our  Changelog  entries for more information. We added the new  Transaction code (List)  and  Transaction code value (List)  endpoints.  We fixed an issue for Deposit (Get) to set the name in transaction_code_values in distribution_splits . more

The General Ledger API was updated on 6/20/2018. See our  Changelog  entries for more information. We made several changes to the following endpoints:   The Journal entry batch (List) endpoint now includes a new search_text  request parameter that can match description  or ui_batch_id . For example, ?search_text=100  returns a list of batches ... more

The Fundraising API (Beta) was updated on 6/19/2018. See our  Changelog  entries for more information. We added the Package list endpoint to return a paginated list of packages. more

We implemented new operation ID values in the OpenApi (fka Swagger) definitions for the Accounts Payable , General Ledger , and Treasury (Beta)  APIs. This change improves client-side tooling support for code generation by making the values more deterministic and friendlier across different languages. Going forward, we expect high stability of ... more

We are aware of an issue with the Journal entry batch (GET) endpoint. A timeout occurs when batches with large numbers of journal entries cannot be returned. We are working to resolve this issue and will post an update as soon as it is available. more

In an upcoming release, 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 ... more

The Fundraising API (Beta) was updated on 6/1/2018. See our  Changelog  entries for more information. We added the Document (Create) endpoint to create a document upload location and unique document identifier for physical attachments. For information about how to create physical attachments, see the Creating Physical Attachments blog post. more

The Gift API (Beta) was updated on 6/5/2018. See our  Changelog  entries for more information. We added the Document (Create) endpoint to create a document upload location and unique document identifier for physical attachments. For information about how to create physical attachments, see the Creating Physical Attachments blog post. more

The Opportunity API was updated on 6/1/2018. See our  Changelog  entries for more information. We added the Document (Create) endpoint to create a document upload location and unique document identifier for physical attachments. For information about how to create physical attachments, see the Creating Physical Attachments blog post. more

We implemented new operation ID values in the OpenApi (fka Swagger) definitions for the Constituent , Fundraising (Beta) , Gift (Beta) , and Opportunity (Beta) APIs . This change improves client-side tooling support for code generation by making the values more deterministic and friendlier across different languages. Going forward, we expect ... more

The Accounts Payable API was updated on 06/01/2018. See our  Changelog  entries for more information. We added the new  Invoice edit (PATCH)   endpoint.  more

In the next release, 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 ... more

The Constituent API was updated on 5/25/2018. See our  Changelog  entries for more information. We added the computed_status  and status_code  properties to the action entity. These properties are available in the Action (Get), Action list (All constituents), and Action list (Single constituent) endpoints. more

We are aware of an issue with the Transaction distribution (List)  endpoint returning incorrect account_class  information. We are working to resolve this issue and will post an update as soon as it is available. Resolved: For the issue reported on 2018-05-09, distribution  account_class  information is now correct. more

The General Ledger API was updated on 05/24/2018. See our  Changelog  entries for more information. We made changes to the following endpoints: The Transaction distribution (List) endpoint now returns proper  account_class  information. The Journal entry batch (GET) endpoint now returns the correct number of   journal_entries .  In the ... more

The Constituent API supports the ability to create attachments that link to external resources and has done so for a while now. However, link attachments aren’t always the best option. Sometimes you want to upload physical files such as images, PDFs, or Word files and add them as physical attachments. And since you don’t want to go to the trouble of ... more

The Constituent API was updated on 5/15/2018. See our  Changelog  entries for more information. We added the Document (Create) endpoint to create a document upload location and unique document identifier for physical attachments. more

The Constituent API was updated on 5/11/2018. See our  Changelog  entries for more information. As previously announced, we updated the Constituent API Action category value from  Phone Call  to  Phone call . This change impacts the  Action (Get)  and  Action list (Single constituent )  endpoints. more

We are aware of an issue where breaking changes in our API management tool are causing  OperationId  values in the Swagger document to be replaced with numeric IDs instead of human readable values. This causes problems when creating autogenerated clients from the Swagger document, and we are actively working to resolve the issue. We will soon release ... more

We are aware of a discrepancy in the values being returned by the  Address list (Single constituent)  and  Address list (All constituents)   endpoints. We are actively working to resolve this issue and will post an update as soon as it is available. more

The Treasury (Beta) API was updated on 04/26/2018. See our  Changelog  entries for more information. For the  Bank account (List)  endpoint, the bank_name  field is now included in the list of returned objects separate from account_name  . The Bank account register (List), Checks (List), Deposits (List), and Adjustments (List) endpoints now ... more

We are aware of an issue with the new  Period summary  and  Period summary list  endpoints returning incorrect balances for some accounts. We will provide an update as soon as it is available, but currently, we recommend not relying on these values. Resolved: For the issue reported on 2017-12-12, incorrect balances have been resolved. more

A future enhancement is planned for the Constituent API.  We will update the Constituent API Action category value from  Phone Call  to  Phone call  for consistency across all endpoints. This change will impact the  Action (Get)  and  Action list (Single constituent)  endpoints. more

The General Ledger API was updated on 04/20/2018. See our  Changelog  entries for more information. We added the Journal entry batch - Patch endpoint. With the new endpoint, note the following: You can edit the  description ,  create_interfund_sets , and  create_bank_account_adjustments  values of an existing journal entry batch. Posted ... more

The Accounts Payable API was updated on 04/20/2018.  We made several changes to the  Invoice attachment  endpoint which now supports Physical attachments. Previously the endpoint only supported Link attachments .  See our  Changelog  entry for more information . more

The Fundraising API (Beta) was updated on 4/19/2018. See our  Changelog  entries for more information.   We added the Fundraiser assignment list (Single constituent), Fundraiser assignment (Create), Fundraiser assignment (Edit), Fundraiser assignment (Delete), and Fundraiser types endpoints.   more

The Constituent API was updated on 4/13/2018. See our  Changelog  entries for more information. We added the  Fundraiser assignment list (Single constituent)   endpoint, and we  deprecated the  Fundraiser list (Single constituent) . more

The Accounts Payable API was updated on 03/30/2018. See our  Changelog  entries for more information . For the Invoice (List) endpoint, we made the following changes: The     payment method  of the invoice is now returned in the listed objects, which includes EFT , Credit card , Bank draft , or Check . The     payment method  field can also be filtered ... more

A future enhancement is planned for the Constituent API. Raiser's Edge NXT recently introduced a new configuration setting for how to display names in the product, and the API will soon reflect this configuration option for consistency. This will affect constituent name properties on the Constituent GET, search, and list endpoints, as well as the ... more

Sometimes developers need to find a constituent record with only a single piece of information to go on, such as an email address, a phone number, or even a nickname. A great way to solve this problem is to use the Constituent (Search) endpoint in the Constituent API. Much like a Google search, the Constituent (Search) endpoint allows you to enter search ... more

The General Ledger API was updated on 03/02/2018. See our  Changelog  entries for more information. We added the following new endpoints: Client names (List) - Get Grant status (List) - Get Grant type (List) - Get Grant custom field (List) - Get   For the Period summary process (Start) endpoint, a fiscal_period_id  was previously required. Now, ... more

What is happening? Blackbaud is requiring an upgrade to TLS 1.1 or above in order to align with industry best practices for security and data integrity set by the Payment Card Industry (PCI) Security Standards Council . On March 15, 2018, we will disable the TLS 1.0 encryption protocol, which will prevent apps still using it from accessing Blackbaud SKY ... more

The Fundraising API (Beta) was updated on 2/27/2018. See our  Changelog  entries for more information.   We added the Fundraiser goal list (Single constituent), Fundraiser goal (Create), Fundraiser goal (Edit), Fundraiser goal (Delete), Appeal categories, Campaign categories, Fund categories endpoints. We also updated  the URL for the Goal ... more

The Constituent API was updated on 2/21/2018. See our  Changelog  entries for more information. The optional  strict_search  query parameter is now available on the Constituent (Search) endpoint. It indicates whether to exclude constituents that sound like the search criteria but are spelled differently. By default, this parameter is set to  ... more

A breaking change is planned for the Fundraising API. We are updating  the URL for the  Goal categories (Get) endpoint  to  /fundraisers/goals/categories .       more

The Fundraising API (Beta) was updated on 2/5/2018. See our  Changelog  entries for more information.   The  type  property is now included on the  fund  entity. more

The Constituent API was updated on 2/2/2018. See our  Changelog  entries for more information.   The  Address list (All constituents) ,  Email address list (All constituents) ,  Online presence list (All constituents) , and  Phone list (All constituents)  endpoints now  include an option to filter based on their associated constituents. The  ... more

The Gift API (Beta) was updated on 1/29/2018. See our  Changelog  entries for more information.   We added the Attachment tags (Get) endpoint and added  the  date  property to  the attachment entity. more

The Fundraising API (Beta) was updated on 1/29/2018. See our  Changelog  entries for more information.   We added the Attachment tags (Get) endpoint and added the  date  property to  the attachment entity.  We also added the  category  property to the campaign, fund, and appeal entities.   more

The Constituent API was updated on 1/25/2018. See our  Changelog  entries for more information.   We added the  date  property to the  attachment  entity  and renamed the Constituent gift entity to Giving Summary. more

The Opportunity API was updated on 1/24/2018. See our  Changelog  entries for more information.   We added the  Attachment tags (Get) endpoint  and added the  date  property to the  attachment  entity. more

The Constituent API was updated on 1/19/2018. See our  Changelog  entries for more information.   We added the Attachment tags (Get) endpoint and applied a  255-character limit to the summary  property  on the  action  entity . more

The General Ledger API was updated on 01/17/2018. See our  Changelog  entries for more information. For the Journal entry batch (Post) endpoint,   transaction_code_value  can now include ""  empty string for   value  .   more

The Accounts Payable API was updated on 01/17/2018.  See our  Changelog  entries for more information. For the Invoice (List) endpoint, we added the    delete , paid , and partially paid  statuses.   more

The Treasury (Beta) API was updated on 01/17/2018. See our  Changelog  entries for more information. The new    payee  field is now returned in the listed objects. The list is now sorted by check number (ascending). We added the  starting_check_number  and ending_check_number  variables to the check filter. When only starting_check_number ... more

The Constituent API was updated on 1/17/2018. See our  Changelog  entries for more information.   New endpoints are now available to edit and delete aliases. more

The Constituent API was updated on 1/11/2018. See our  Changelog  entries for more information.   We added several new endpoints for name formats and replaced the Name format list (Single constituent) endpoint with the Name format summary endpoint. more

The Constituent API was updated on 12/20/2017. See our  Changelog  entries for more information. We added the Education list (All constituents) endpoint. T h e  Relationship list (Single constituent)  and  Relationship list (All constituents)   endpoints now return the  reciprocal_relationship_id  property. T h e  Constituent custom ... more

The Fundraising API (Beta) was updated on 12/15/2017. See our  Changelog  entries for more information.   We added the Goal categories and Package endpoints. more

The Gift API (Beta) was updated on 12/11/2017. See our  Changelog  entries for more information.   We added the  package_id  property to the  gift split  entity .   more

The Constituent API was updated on 12/7/2017. See our  Changelog  entries for more information. We added the following endpoints: The Alias list (Single constituent) endpoint The Alias (Create) endpoint The Name format configuration list endpoint The Name format types endpoint more

Lately some confusion has surfaced in the Community and beyond about which ID is which when interacting with SKY API and its underlying products. I would like to provide some clarity on this front and hopefully provide some insight into why things work the way they do.   First off, I would like to focus on two types of IDs: system record IDs and lookup IDs. In ... more

The Opportunity API was updated on 12/1/2017. See our  Changelog  entries for more information.   The  Opportunity list endpoint  now includes an option to filter opportunities based on their associated constituents. more

The Gift API (Beta) was updated on 12/1/2017. See our  Changelog  entries for more information.   The  Gift list endpoint  now includes options to filter gifts based on post status and gift type .   more

The Constituent API was updated on 12/1/2017. See our  Changelog  entries for more information.   We added the Relationship list (All constituents) endpoint. We added the Alias types endpoint. T he  Relationship list (Single constituent)  endpoint now returns the  date_added  and  date_modified  properties on the  relationship  entit ... more

The General Ledger API was updated on 11/20/2017. See our  Changelog  entries for more information. We added the following new  endpoints: Period summary (List) - Get Period summary process - Get Period summary process (Start) - Post more

The Accounts Payable API was updated on 11/17/2017.  See our  Changelog  entries for more information.   We added additional fields to the  Payment term (List)   endpoint.  more

The Constituent API was updated on 11/9/2017. See our  Changelog  entries for more information.   We added the Note list (All constituents) endpoint. We updated the Note (Get) and Note list (Single constituent) endpoints to return the  date_added  and  date_modified  properties. We updated the Constituent (Search) endpoint to return the  ... more

POST gift functionality is finally here! The Gift (Create) endpoint was highly requested across all of our developer feedback channels, and with its recent release, we want to call out some information to help you get started.   Several properties are required to successfully create a gift. You need to provide the amount , type , constituent_id , ... more

The Gift API (Beta) was updated on 10/31/2017. See our  Changelog  entries for more information.   We added the  batch_number   property to the  gift  entity.   more

A breaking change is planned for the Constituent API. We are updating the name format entity to support custom name formats and provide a more robust entity . See our  Changelog  for more information. more

The Constituent API was updated on 10/20/2017. See our  Changelog  entries for more information. The  Constituent list endpoint  now includes an option to filter constituents based on their record IDs. The optional  constituent_id  query parameter, which can be specified multiple times to imply a logical OR, filters the results to only ... more

Hello, SKY API Community!    We will soon make a breaking change announcement for the Constituent API to support the next generation of name formats. This breaking change will allow us to deliver the top requested endpoints for addressee and salutation management.   I want to stress that we do not take breaking changes lightly and that we deliberated a ... more

The Accounts Payable API was updated on 10/12/2017.  See our  Changelog  entries for more information.   We added the new  Payment term (List)   endpoint.  more

Our team was recently asked to clarify our recommendation on how to get and maintain authorization to SKY API for apps that offer no user interface, such as apps that perform sync operations to and from Blackbaud products. This blog post addresses the confusion around this and describes the basics for establishing a long-lasting SKY API connection ... more

The Gift API (Beta) was updated on 10/4/2017. See our  Changelog  entries for more information.   We added the  acknowledgements ,  receipts , and  balance  properties to the  gift  entity.   more

The Accounts Payable API was updated on 9/28/2017.  See our  Changelog  entries for more information.   For the  Vendor  endpoint, we added the payment_default field which includes credit limit, payment terms, and bank account information.  more

As I'm sure many of you know, the volunteer module for Raiser's Edge includes a set of robust and powerful entities to track volunteer efforts, and Blackbaud has relied on partners and clients to build great things on top of these entities. We want to continue that tradition by delivering the Volunteer API as our next big release under the SKY API ... more

The Constituent API was updated on 8/28/2017. See our  Changelog  entries for more information.   We added the Action locations  endpoint. We updated the Constituent (Create)   endpoint to set the default value for the  gender  property to unknown . We updated the action   entity to add new properties and make the completed_date  property ... more

The Fundraising API (Beta) was updated on 8/28/2017. See our  Changelog  entries for more information.   We added several new endpoints to manage attachments for appeals, campaigns, and funds. more

The General Ledger API was updated on 8/14/2017. See our  Changelog  entries for more information.   For the Project endpoint, we added the division, department, location, and type filters. Additional data is also returned. For the Transaction distribution (List) endpoint, we added the encumbrance and post date filters. Additional data is also ... more

To improve security, we will be disabling support for ciphers now considered weak. This change will be implemented in the next 1-2 business days. We do not anticipate this update will impact any SKY API applications or integrations. However, we advise you to monitor upcoming SKY API activity for any observed disruption. more

The Gift API (Beta) was updated on 8/8/2017. See our  Changelog  entries for more information.   We added the  Gift subtypes (Get)  endpoint. We added the  payments  property to the  gift entity . more

The Constituent API was updated on 8/8/2017. See our  Changelog  entries for more information. We added the  Relationship (Edit)  endpoint.   more

Want a concise recap of what's been delivered for SKY API in the past quarter? Curious to learn what the SKY API product teams are working on now or have queued up next on the roadmap? Want to engage directly with the SKY API product managers and ask them anything ? If so, be sure to register for the Blackbaud SKY API and SKY UX Quarterly Update webinar series. ... more

It would be wonderful if every call to a SKY API had valid data, proper formatting, and an environment that was never in a bad state. Unfortunately, things don’t always work that way. Many problems can occur during an API request, ranging from bad requests to insufficient permissions to issues with SKY API itself. This blog post describes some errors ... more

Lately we’ve been getting a lot of questions and hearing a bit of confusion around how lists work within SKY API. I’m the first one to admit that they are a bit complex, so I would like to take a minute to give you a glance into how the sausage is made, explain why and how lists work the way they do, and hopefully provide some insights to improve your experience ... more

The Accounts Payable API was updated on 6/30/2017. See our  Changelog  entries for more information.   We added the following new  endpoints: Invoice attachment - Post Media type (List) - Get more

The Constituent API was updated on 6/27/2017. See our  Changelog  entries for more information. We updated the concept of inactive addresses to be consistent across address endpoints and better aligned with the web interface. Now, addresses are only marked inactive if their end_date is in the past. more

The General Ledger API was updated on 6/15/2017. See our  Changelog  entries for more information. We made several changes to the Get Account (Search), Get Project (Search), Get Journal entry batch (List), and Get Transaction distribution (List) endpoints.   The following properties are now returned: date_added ,  date_modified , added_by , and ... more

API request throttling is a fairly standard practice throughout the web. Most SaaS companies that provide web APIs do not permit unlimited API use. Some companies throttle requests to protect their backend resources where load and throughput are important metrics of service delivery, while others throttle requests as part of a broader business ... more

Developers using APIs to deliver mission-critical functionality in their applications need to know immediately if those APIs are unavailable or response times are spiking. It's also important to know why an incident is occurring and when a resolution could be expected.  For this reason, we introduced a SKY API Status  page last year, to keep our ... more

The Constituent API was updated on 5/12/2017. See our  Changelog  entries for more information.   We added the  comment  property to the relationship entity. more

The Opportunity API was updated on 5/10/2017. See our  Changelog  entries for more information.   The  Opportunity (GET)  endpoint now returns the  date_added  and  date_modified  properties. more

The Constituent API was updated on 5/9/2017. See our  Changelog  entries for more information.   The Communication preference (Edit) endpoint can now patch the start and end fields . The Action (Get) and Action list (Single constituent) endpoints now return the date_added and date_modified properties. more

The Opportunity API (Beta) was updated on 5/9/2017. See our  Changelog  entries for more information.   The Appeal list, Campaign list, and Fund list endpoints now exclude inactive records by default. more

We are excited to see more and more people asking questions and sharing feedback in the SKY API Community!  All this growth and activity means it is a great time to post some security-related best practices and reminders.   Today I’d like to talk about posting questions and screenshots.   When working with SKY API, there are three sensitive values that ... more

The General Ledger API was updated on 5/5/2017. See our  Changelog  entries for more information.   We increased the maximum record limit from 500 to 5000 on the  Transaction distribution  endpoint. We added the following new  endpoints: Budget grant (List) - Get Budget project (List) - Get more

The Accounts Payable API was updated on 5/5/2017. See our  Changelog  entries for more information.   We added the following new  endpoints: Invoice 1099 amount (Get) Invoice 1099 box numbers (Get) more

The Shared Changelog was updated on 5/4/2017. See our Changelog entries for more information. New We added a new step-by-step guide to help you learn the steps required to Create an App with SKY API . We recommend you complete this guide after you follow the Getting Started documentation. more

Last month , we covered the basics of how to synchronize data to a custom data source with SKY API. It is equally important to synchronize the changes in your custom data source with your data in Raiser’s Edge NXT. If you have a Workato subscription, then the Raiser’s Edge NXT connector available in the easy-to-use Workato recipe builder might suit your ... more

The Opportunity API was updated on 4/28/2017. See our  Changelog  entries for more information.   The new  linked_gifts  property on the  opportunity  entity provides an array of identifiers for gifts that are related to an opportunity. more

Schedule maintenance is planned for April 30, 2017.  more

The Gift API (Beta) was updated on 4/25/2017. See our  Changelog  entries for more information.   We added the following new endpoints : Gift custom field (Create) Gift custom field (Edit) Gift custom field categories (Get) Gift custom field category values (Get) more

The Constituent API was updated on 4/25/2017. See our  Changelog  entries for more information.   We added several new properties to the relationship  entity . We added the following new endpoints: Relationship (Create) Relationship types (Get) Organization contact types (Get) more

The Treasury API (Beta) was released for a public beta on 4/25/2017. This API manages information related to bank accounts, including related entities such as adjustments, checks, and deposits. The initial release contains endpoints to retrieve a list of all bank accounts and bank account transactions, and to manage deposits, cash receipts, and ... more

The Constituent API was updated on 4/20/2017. See our  Changelog  entries for more information.   The date_added  parameter on the  Constituent list  endpoint now returns a   sort_token  to ensure that constituents are stably sorted . The new  sort  parameter on the  Constituent list  endpoint sorts constituents based on specified fields. more

The Opportunity API (Beta) was released for a public beta on 4/12/2017. This API manages opportunity information and related entities such as opportunity fundraisers, opportunity attachments, and opportunity custom fields. See the  changelog  for more information. more

Synchronizing data across multiple data sources is often an integral part of any strategy that uses multiple third-party providers. If you have a Workato subscription, then our Raiser’s Edge NXT recipe that uses the easy-to-use Workato UI might suit your needs. However, if you don’t have a subscription to Workato or have a complex synchronization ... more

The Gift API (Beta) was updated on 3/20/2017. See our  Changelog  entries for more information.   We added the  post_date  property to the  gift entity . more

In response to a request from our SKY API Community , we are pleased to announce a new PHP code sample  and accompanying PHP tutorial . These two new resources demonstrate the Blackbaud Auth Code Flow  using PHP. Thanks for helping us improve the documentation! more

Good news, everyone! I am pleased to announce that we have released two new APIs as open Betas today , the Gift API and Fundraising API . Let me explain how open Betas work:   Our Process SKY API development teams take an iterative approach to expanding our existing and upcoming APIs. What this means for new endpoints, entities, and APIs is that the initial ... more

The SKY API developer site now offers commenting capability through Disqus. We encourage community involvement to improve our documentation. We will monitor comments just like we monitor feedback in our GitHub repository , and we will incorporate feedback to make our docs better. See something that is unclear? Want more detail? Leave a comment and ... more

A comment on a recent Community blog post raised a question about whether a planned change for the constituent API was a breaking change. This question prompted us to review our definition of breaking changes and document how we handle those changes. This blog post defines breaking changes for the SKY API, describes how we announce breaking changes and ... more

The Constituent API was updated on 2/23/2017. See our  Changelog  entries for more information.   The new  custom_field_category  parameter to the Constituent list  endpoint retrieves constituents based on their active custom fields . The  Fundraiser list (Single constituent)  endpoint now returns the appropriate value for  the  ... more

We are aware of an issue on the Control Panel, Applications page in SKY API enabled Blackbaud products. The Applications page does not load. Previous applications you authorized do not appear. While they have not been deleted, during this time you may get an error message that your application doesn’t have access to any SKY API enabled Blackbaud ... more

The Constituent API was updated on 2/9/2017. See our  Changelog  entries for more information.   New We added the following endpoints: Countries (Get) Education (Create) Education (Edit) Education (Delete) Education schools (Get) Education types (Get) Education statuses (Get) Education subjects (Get) Education degrees (Get) ... more

We are excited to announce that SKY API Documentation is now open source in GitHub . To make our documentation even better, we welcome contributions from the developer community in the form of pull requests or issues.   See something in the docs that could be clearer? A typo? Let us know , or help us out and submit a fix.   On the SKY API developer website , you ... more

Ratings are among the most complex entities that the Constituent API surfaces. The complexities include optionally required fields, value fields that are dynamic based on the data type, and categories that may or may not include a source. So I’ve put together an in-depth guide to ratings and their intricacies.   When dealing with ratings, the first ... more

A breaking change is planned for the Constituent API. We are updating properties on the education entity to improve overall feature parity and to support upcoming education endpoints. See our  Changelog  for more information.   more

The General Ledger API was updated on 01/18/2017. See our  Changelog  entries for more information. New We added the following endpoints:  Account Project Account cashflows (List) Account working capitals (List) Account custom fields (List) more

The Constituent API was updated on 1/11/2017. See our  Changelog  entries for more information. We updated  the  do_not_mail   and  preferred   properties on the Address (Create) endpoint to set the default value to false. more

The Constituent API was updated on 1/10/2017. See our  Changelog  entries for more information. We added the  campus ,  known_name , and  social_organization   properties to the education entity. more

The Constituent API was updated on 1/6/2017. See our  Changelog  entries for more information. We updated the Constituent custom field list (Single constituent) and the Constituent code list (Single constituent) endpoints to populate some of their properties. more

  We added a new Status link to the Support menu. This link takes you to our new SKY API status page. The status page provides the current state of API availability, as well as specific details on downtime incidents. We also provide the option for you to subscribe to automatic incident notifications by email, SMS, or feed. For more information, including ... more

The Accounts Payable API was updated on 12/06/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Invoice custom field (List) Vendor custom field (List) We added new custom field entities to the following endpoints:  Invoice (Post) Invoice (Get) Vendor (Post) Vendor (Get) Changed For consistency ... more

The General Ledger API was updated on 12/06/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Journal entry custom field (List) Project custom field (List) Budget Budget (List) Budget account (List) Ledger summary (List) We added new custom field entities to the following endpoints:  Project ... more

The Constituent API was updated on 11/16/2016. See our  Changelog  entries for more information. The Constituent list endpoint now includes an option to filter constituents based on their associated constituent codes.   more

The Constituent API was updated on 11/14/2016. See our  Changelog  entries for more information.   New We added the following endpoints: Constituent code list (All constituents) Constituent custom field list (All constituents) Changed We implemented a new naming convention for list endpoints to better indicate whether the endpoints return ... more

The General Ledger API was updated on 11/01/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Create project (Post) Create project contact (Post) more

The Constituent API was updated on 10/20/2016. See our  Changelog  entries for more information.   New We added the following endpoints: Address (List) Email address (List) Online presence (List) Phone (List) We are aware of an issue with the new Address (List) where the formatted_address  and  inactive attributes are not populated on the ... more

The Constituent API was updated on 10/17/2016. See our  Changelog  entries for more information.   Changed The  fundraisers  property on the  action  entity now contains an array of strings populated with the constituent_id  of fundraisers instead of an array of action fundraiser entities . New We added the following endpoints: Action custom ... more

The Shared Changelog was updated on 10/17/2016. See our  Changelog entries for more information.   New Logos can now be associated with your applications. The logo is the icon that users will see on the consent form when they give an application authorization to use their product's account to access the API. Logos can be added to new and existing ... more

We are aware of an intermittent issue affecting a subset of Raiser's Edge NXT tenants, whereby Constituent API requests result in exceedingly long response times or timeouts. We are researching the issue and will post another update soon when we have more information. Resolved: Service has been restored as of 10/17/2016 at 9:30am EDT (1:30pm UTC). more

The Accounts Payable API was updated on 10/12/2016. See our  Changelog  entries for more information.   Changed For consistency across APIs, we implemented the following changes: All responses to POST requests changed from "Recordid" to "record_id". The following endpoints and their associated fields changed from CamelCase to snake_case: ... more

The General Ledger API was updated on 10/06/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Fiscal year (List) Class (List) Account structure Account segment value (List) Account code (List) Account fund (List) Project type (List) Project status (List) Project division (List) Project ... more

The Constituent API was updated on 10/3/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Prospect status (Get) Fundraiser (List) more

The Constituent API was updated on 9/28/2016. See our  Changelog  entries for more information. Breaking Change Planned We will change the  fundraisers  property on the  action  entity so that it contains a list of strings populated with the  constituent_id  of fundraisers instead of an array of  action fundraiser  entities.   Changed Th e  ... more

A breaking change is planned for the Constituent API. See the  changelog  for more details.   We will change the query string parameter  includeInactive  to  include_inactive  on the  Constituent (List) endpoint . more

The Constituent API was updated on 9/14/2016. See our  Changelog  entries for more information. Breaking Change Planned The Constituent (List) endpoint will no longer return deceased constituents by default. Instead, they will be included by setting a new include_deceased  option to true. We will also change the following query string ... more

The Backend for Frontend, or BFF, pattern has been the talk of the town in the world of microservices over the past few months. Since we are a microservice shop under the hood here at Blackbaud, I thought that I would take some time to talk about the BFF pattern and how it may relate to your applications as you work with SKY API.   But first, a quick overview of ... more

The Constituent API was updated on 9/7/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Communication preference (Edit) Constituent rating (Create) Constituent rating (Edit) Constituent rating (Delete) Changed We added the  lookup_id  property to the search results entity. more

The Constituent API was updated on 8/31/2016. See our  Changelog  entries for more information. New We added the following endpoints:  Action Attachment (Get list) Action Attachment (Post) Changed We changed the URL for the Constituent Attachment (Post) endpoint to  /constituents/attachments . The  constituentId  is now expected in the ... more

A breaking change is planned for the Constituent API. See the  changelog  for more details.   All  POST  endpoints will now return a JSON object containing the id, in the form  { "id": "123" } , instead of the current string response. UPDATE : This change took effect on Friday, September 02, 2016. more

The Constituent API was updated on 8/26/2016. See our  Changelog  entries for more information. Breaking Change Planned We will change the URL for the Constituent Attachment (Post) endpoint to  /constituents/attachments . Changed We renamed the  proposal_id  property to  opportunity_id  on actions to be consistent with product verbiage. ... more

Breaking changes are planned for the Constituent API.  See the  changelog  for more details. The data type assigned to the  value  property on the  rating  entity will be changed from a string to an object. As it stands today, all values are returned as a string, which must then be parsed (by the requestor) into the intended type. After release, the ... more

The Constituent API was updated on 8/22/2016. See our  Changelog  entries for more information. New We added a new endpoint -- Currency configuration (Get). Changed The data type assigned to the  value  property on the  rating  entity was changed from a string to an object. Previously, all values were returned as strings that needed to be parsed (by ... more

We changed the default and maximum record limits on several search and list endpoints. See the General Ledger Changelog   and Accounts Payable Changelog for more information. more

The Constituent API was updated on 8/11/2016. See our Changelog entries for more information. New We added the following endpoints:  Communication preference (Create) Communication preference (Delete) Communication preference (Get list) Changed We added  start  and  end  to the Communication Preference entity to represent optional ... more

Accounts Payable API is now available in our  Partner Beta . Use this API to manage accounts payable, including vendors and invoices. Review SKY's authorization workflow SKY API uses the OAuth 2.0 protocol to authorize API requests. This provides a mechanism for your application to access Blackbaud customer data without exposing any user ... more

The Constituent API was updated on 8/3/2016. See our Changelog entries for more information. New We added a new endpoint -- Communication preference (Get list). Changed We removed  boolean_value ,  code_table_value ,  constituent_id_value ,  date_value ,  fuzzy_date_value ,  currency_value , numeric_value ,  text_value  and replaced them ... more

As a developer building an app against the Sky API, you're going to have occasions where it will be handy to have tools that can easily generate one-off requests to the API from somewhere other than your app. REST clients are one such tool. This blog post briefly discusses the purpose of a REST client and the benefits of adding it to your toolset. more

A breaking change for the Constituent API is planned to take effect on Monday, August 1st.  See the  changelog  for more details. We willl remove boolean_value ,  code_table_value ,  constituent_id_value ,  date_value ,  fuzzy_date_value ,  currency_value , numeric_value ,  text_value  and replace them with a single  value  property for use ... more

The Constituent API was updated on 7/27/2016. We added a new endpoint -- Constituent (Edit). See our  Changelog  entries for more information. more

The Constituent API was updated on 7/22/2016. See our  Changelog  entries for more information. New Added the following endpoints: Rating Custom field Custom field category values Changed We added the  date_added ,  date_modified ,  title_2 ,  suffix_2 ,  marital_status ,  deceased_date  properties to the Constituent entity. more

The Constituent API was updated on 7/18/2016. See our   Changelog   entries for more information. New We added the following endpoint: Operation Method Route Constituent (Create) POST /constituents Changed We removed the  business  property from the Constituent entity. more

The Constituent API was updated on 7/7/2016. See our  Changelog  entries for more information. We renamed  kind  to  type  and  types  to  tags  on the Attachment entity. We renamed  nickname  to  preferred_name  on the Constituent entity. more

The Constituent API was updated on 7/1/2016. See our  Changelog  entries for more information. Added the following endpoints: First, latest, greatest gifts. Custom constituent field categories Titles Suffixes Marital Statuses more

A breaking change for the Constituent API is planned to take effect on Wednesday, July 6th.  See the changelog for more details. We will rename kind to type and types to tags on the Attachment entity. We will rename nickname to preferred_name on the Constituent entity. more

In the coming days, a breaking change will occur for General Ledger API. We plan to remove the Journal entry batch (Edit) endpoint. See our  Changelog  entries for more information. UPDATE: This change took effect on Tuesday, July 5. more

The Constituent API was updated on 6/27/2016. See our  Changelog  entries for more information.   Added a new endpoint -- Address (Edit) We now accept application ID and secret in the request body, in addition to the Authorization header.   Created a  C# Auth Code Flow code sample  and  tutorial . Added the ability to retrieve inactive email  ... more

The Constituent API was updated on 6/15/2016 and 6/20/2016. See our  Changelog  entries for more information.   Added a new endpoint -- Address (Delete). Updated the  Constituent (Get List)  endpoint to include a new, optional  postal_code  parameter which provides the ability to filter constituents by postal code based on their preferred ... more

General Ledger API is now available in our Partner Beta . Use this API to post transactions to the general ledger. Review SKY's authorization workflow SKY API uses the OAuth 2.0 protocol to authorize API requests. This provides a mechanism for your application to access Blackbaud customer data without exposing any user credentials ... more

As part of making the transition from the SKY API's  Tech Preview  phase to  Beta ,   we will be introducing a breaking change . We wanted to let you know in advance, so that you can prepare to update any code currently consuming the SKY API. We will be adding a versioning indicator to the Constituent API and General Leger APIs' base URLs. Specifically, all ... more

The Constituent API was updated on 6/9/2016. See our  Changelog  entries for more information.   We've added the OAuth2  Implicit Flow  for use in web browser and mobile apps where application secret confidentiality is not guaranteed. A new feature allows you to export API definitions in Swagger and WADL formats from within the  API Console . Use ... more

The Constituent API was updated on 6/1/2016 and 6/6/2016. See our  Changelog  entries for more information. Added the following endpoints:   Lifetime giving (Get) Memberships (Get list) Action types (Get list) Action status types (Get list)   more

The Constituent API was updated on 5/24/2016. See our  Changelog  entry for more information. Renamed send_mail to do_not_mail on the Address entity. Added the Address types (Get List) endpoint. more

The Constituent API was updated on 5/20/2016. See our  Changelog  entry for more information. Breaking changes announced on the Address entity and Constituent entity.  New endpoints to add, edit, and delete Phones. New endpoints to list Phone types, Email address types, Online presence types, and Constituent code types.  more

During our  SKY API  Tech Preview 2.0  period, the API will be subject to a few periodic breaking changes as we refine and improve it. We wanted to let you know in advance  that one of these changes is scheduled to be introduced in the next day or so.   We will be removing business and seasonal properties for an Address and the business property from a ... more

The Constituent API was updated on 5/13/2016. See our Changelog entry for more information. A next_link property has been added to our paginated collection responses and represents the URI for the next page of results. This property takes into account any relevant pagination parameters, such as limit , offset , or last_modified , and date_added ... more

Welcome to SKY API. This article provides guidance for those of you who are new to the API. I t assumes that you recently requested or were approved for a subscription. If not, be sure to complete our  Getting Started  guide. After you are approved, your developer account is added as a user in the sandbox database/tenant and your subscription key is ... more

The Constituent API was updated on 5/6/2016.   See our  Changelog  entry for more information. Added granular address properties Added international address field support for specific countries. Added constituent_id property to entities such as Address , Attachment , Constituent code , Email address , and more... top and skip pagination ... more

During our  SKY API  Tech Preview 2.0  period, the API will be subject to a few periodic breaking changes as we refine and improve it. We wanted to let you know in advance  that one of these changes is scheduled to be introduced in the next day or so.   Pagination  will be facilitated through the results via the use of  limit  and  offset  instead of  top ... more

  During our  SKY API  Tech Preview 2.0  period, the API will be subject to a few periodic breaking changes as we refine and improve it. We wanted to let you know in advance  that one of these changes is scheduled to be introduced in the next day or so.   We will replace existing  PUT  endpoints to use  PATCH , instead. Unlike  PUT ,  PATCH  can be used to ... more

During our SKY API  Tech Preview 2.0  period, the API will be subject to a few periodic breaking changes as we refine and improve it. We wanted to let you know in advance that one of these changes is scheduled to be introduced in the next day or so.   We will be standardizing the shape of our responses that return a collection of objects. This ... more