- Create an account on the SKY API developer portal if you don't already have one. This will need to be provisioned through your school.
- Create a new application under your account in My applications
- While you don't have to have your app deployed yet, you will need to know where it will be deployed, as you need a few URLs:
- The URL to the app itself
- A redirect URI for OAuth 2.0 authentication (use a PHP or TypeScript library for this!)
- Make a note of the Application ID (OAuth client_id) and Primary application secret (OAuth client_secret) (Blackbaud recommends rotating your secrets every 90 days, and provides a primary and secondary to facilitate doing this without a break in service).
- Make a note of your subscription key under My subscriptions. Same deal on 90-day rotations. You will need this for API calls.
- Do whatever you need to do to deploy your actual app code.
- To allow your Blackbaud instance to connect to your app, you need to connect it in the Marketplace. Use the previously-noted
client_id
to do this.