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