Share via


Blackbaud SKY Add-ins

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, 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 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

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

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

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.