Understanding the Integration Error Note
This article lists possible sync errors that could arise with your SIS (Student Information System). We will keep adding more as we encounter it.
Error Indicator Colors:
Yellow ⚠️ Warning: This indicates that there is an issue, but the sync will continue to run. However, some data might be missing. Example :
"Skipped sync for staff 3292923 due to missing email."
Red ⚠️ Error: Indicates a critical issue that stops the sync process. No data will be fetched until the error is resolved. Example :
"Unauthorized: You do not have access to this route."
How to Address These Errors:
Yellow Warnings: Review the specific message to identify what data might be missing or if any action is needed. The sync will complete, but you may need to correct or add missing information.
Red Errors: These are critical errors that prevent the sync from completing. Carefully read the error message to determine necessary corrective action, such as updating credentials, permissions, or data.
Examples of Error :
Error | Reason |
Bad Request: The refresh token was not valid  | Warning: RED Diagnose: Re-authorize Blackbaud connection in Orah |
Service Unavailable: Unable to reach Blackbaud Servers, please try again later. HTTP error from resource: http://api.sky.blackbaud.com/school... 
| Warning: RED Diagnose: This is an error from Blackbaud side, please reach out to your SIS Blackbaud. |
Unable to sync listDorms. This requires at least one of the following roles in the Education Management system: Dorm Group Manager, Dorm Supervisor, Pending Dorm Supervisor.  | Warning: YELLOW Diagnose: Provide the admin user with the required role access in your SIS.
|
Skipped sync for staff xyz due to missing email 
| Warning: YELLOW Diagnose: Add email to staff profile in your SIS |
Schedule data not syncing or returning empty results | Warning: RED |
Access denied due to missing subscription key
| Warning: RED |
Requires SKY API Advisory Group Manager role | Warning: YELLOW needed. |
If you encounter server-related or unknown errors, check Blackbaud’s system status page before troubleshooting further: https://status.blackbaud.com
Scope & Permissions:
Blackbaud
Scope & Permissions for Blackbaud
Endpoint Name | Sync Object | Required Roles |
coreSchoolLevels | Attendance History, Group, House | SKY API Data Sync, Any Manager Role |
listDorms | House | Dorm Group Manager, Dorm Supervisor, Pending Dorm Supervisor |
academicSections | Group | Academic Group Manager |
academicsStudentsBySection | group | Academic Group Manager, Teacher |
athleticTeams | Group | Athletic Group Manager, Team Schedule Manager, Coach, Pending Coach |
activitiesSections | Group | Activity Group Manager |
advisoriesSections | Group | SKY API Advisory Group Manager |
extendedUsers | Student & Contacts | SKY API Data Sync |
userById | Student & Contacts | SKY API Data Sync |
coreOfferingTypes | Attendance History, Roll (Pull) | Academic Group Manager, Platform Manager, Schedule Manager |
coreYears | Group | Academic Group Manager, Schedule Manager, Platform Manager, Any Manager Role |
excusedTypes | Attendance History, Pass (Push), Roll(Pull) | SKY API Basic, Any Manager Role |
coreGradeLevels | Student & Contacts | Academic Group Manager, Schedule Manager, Platform Manager, Any Manager Role |
attendance | Attendance History, Roll (Pull), Roll(Push) | Attendance Manager |
venuesBuildings | Group, Location | Team Schedule Manager, Coach, Athletic Group Manager, Pending Coach |
scheduledMeetings | Attendance History, Roll (Pull), Group (Meeting Times) | Academics Group Manager, Advisory Group Manager, Platform Manager, Activity Group Manager, Athletic Group Manager, Scheduling Manager |
tableTypes | Contact Relationship type filters | - (Still in beta so no roles specified) |
tableTypeValues | Contact Relationship type filters | - (Still in beta so no roles specified) |
athleticsVenues | Location | Athletic Group Manager, Team Schedule Manager, Coach, Pending Coach |
Re-authorizing the Blackbaud Integration in Orah
If you continue to see permission-related or authorization errors after updating roles in Blackbaud, re-authorizing the integration may be required.
Steps to re-authorize:
Go to App Directory in Orah
Click on Integrations tag and Select Blackbaud
Click on three dots at the top right and click Reauthorize with Blackbaud
Log in using a Blackbaud admin account with the required roles
Retry the sync
💡 Tip: In most cases, role changes take effect without reconnecting. Re-authorization is recommended only if errors persist.
For errors that mention unknown issues, server failures, or unreachable endpoints, please contact your SIS provider (Blackbaud), as they have the most visibility into API availability. If the issue persists or you need help interpreting an error, contact us at support@orah.com.