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 incounter 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 |
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 |
Know errors with Scope & Permissions : 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) |
Know errors with Scope & Permissions : Veracross
Sync Object | Required scopes (all are needed) |
house | boarding.dorms.students:list, boarding.dorms:list |
staff | staff_faculty:list, households:list |
Student | students:list, households:list, parents:list, contact_info:list |
Contact | households:list, parents:list, contact_info:list, relationships:list |
Attendance History | classes:list, classes.attendance:list |
Roll (Pull) | classes.attendance:list, classes.attendance:list, classes.attendance:update, master_attendance:list, master_attendance:update |
Roll (Push) | classes.attendance:list, classes.attendance:update |
Roll (Push - Daily attendance) | master_attendance:list, master_attendance:update |
Pass | classes:list, academics.classes.meeting_times:list, classes.attendance:list, classes.attendance:update, master_attendance:list, master_attendance:update |
Group (Academics, Advisories, Homeroom) | staff_faculty:list, classes:list, academics.enrollments:list |
Group (Athletics) | staff_faculty:list, classes:list, athletics.rosters:list |
Group (Programs) | staff_faculty:list, classes:list, programs.enrollments:list |
Group Meeting | academics.classes.meeting_times:list |