Blackbaud SKY Add-ins

  • Reference

Use the SKY Add-ins connector to validate user identity tokens issued by the Blackbaud Host application.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Blackbaud Support
URL https://www.blackbaud.com/support
Email skyapi@blackbaud.com
Connector Metadata
Publisher Blackbaud, Inc.
Website https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Privacy policy https://www.blackbaud.com/privacy-shield
Categories Sales and CRM;Productivity

This connector is built on top of Blackbaud's SKY API, and provides operations to facilitate working with user identity tokens issued to SKY Add-ins by the Blackbaud host application.

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, the Microsoft Power Platform application from the Blackbaud Marketplace must be connected to the 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 Blackbaud 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

Send an HTTP request

Sends an HTTP request to the specified SKY API endpoint.
Validate a user identity token

Validates a user identity token.

Send an HTTP request

Operation ID:
SendHttpRequest

Sends an HTTP request to the specified SKY API endpoint.

Parameters

Name Key Required Type Description
Method
 method True string

The HTTP method to use.
Relative path
 path True string

Relative path after https://api.sky.blackbaud.com (ex: '/constituent/v1/addresses')
Query parameters
 query object

Specifies query parameter name and value pairs to include with the request.
Headers
 headers object

Specifies header name and value pairs to include with the request.
Body
 body string

Enter request content in JSON.

Returns

Validate a user identity token

Operation ID:
ValidateUserIdentityToken

Validates a user identity token.

Parameters

Name Key Required Type Description
User identity token
 uit True string

The user identity token string.
Application ID
 application_id True uuid

The expected SKY application identifier to which the user identity token was issued.

Returns

The user identity token details

Body
PowerAutomateUIApi.ValidateUserIdentityTokenResponse

Definitions

PowerAutomateUIApi.ValidateUserIdentityTokenResponse

The user identity token details

Name Path Type Description
User ID
 user_id string

The Blackbaud user's identifier.
Email
 email string

The Blackbaud user's email address.
Last name
 family_name string

The Blackbaud user's last name.
First name
 given_name string

The Blackbaud user's first name.
SKY application ID
 application_id string

The identifier of the SKY application to which the user identity token was issued.
Environment ID
 environment_id string

The current environment identifier.