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 Veracross Integration Errors
Error | Reason |
Unauthorized: You do not have access to this route | Warning: RED Diagnose: The required OAuth scopes are missing or not enabled in Veracross (Axiom). Ensure all scopes listed in the table below are enabled, then re-authorize the Veracross integration in Orah. |
Something went wrong while fetching data filters | Warning: RED Diagnose: The scope event_groups_members:list is missing. Enable this scope in Axiom (Veracross Marketplace) and retry the sync. |
Error in getAccessToken for integration: veracross | Warning: RED Diagnose: The refresh token has expired or was revoked in Veracross. Re-authorize the integration in Orah → App Directory → Veracross.
|
Skipped sync for staff [ID] due to missing email
| Warning: YELLOW Diagnose: The staff member’s profile in Veracross does not have an email address. Add an email in Veracross and retry the sync. |
Scopes and Permissions for 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) | academics.classes.meeting_times:list |
Group Meeting (Programs) | programs.classes.meeting_times:list |
Roll (Pull – Group Events) | events.athletics:list, events.group_events:list, event_groups_members:list |
Roll (Push – Events) | events.event_attendance:create, events.event_attendance:list, events.event_attendance:read, events.event_attendance:update, events.event_attendance:delete |
Pass (Push – Events) | classes:list, academics.classes.meeting_times:list, classes.attendance:list, classes.attendance:update, master_attendance:list, master_attendance:update |
Group (Events) | events.group_events:list, event_groups_members:list, events.athletics:list |
Group Meeting (Athletics) | athletics.team.practice_schedules:list |
Group Meeting (Events) | events.group_events:list, event_groups_members:list, events.athletics:list |
Location | academics.rooms:list |
Prerequisites Before Connecting Veracross to Orah
Before setting up the Veracross integration:
The authorizing user must have highest admin authority in Veracross
Log into Axiom (Veracross Marketplace)
Search for Orah
Enable all scopes listed in the table above (including Houses, even for day schools)
Obtain your Client ID, Client Secret, and School Route
Enter these details in Orah → App Directory → Veracross
Troubleshooting & FAQs
Groups are not syncing
Check that the authorizing user has highest admin authority and that event_groups_members:list is enabled.
Where do I enable scopes?
Scopes are enabled in Axiom (Veracross Marketplace). Only your school’s Veracross admin can enable them.
Do day schools need House (boarding) scopes?
Yes. Even day schools should enable:
boarding.dorms:list
boarding.dorms.students:list
For errors related to unknown issues, access denial, or server unavailability, please contact Veracross directly, as they have visibility into API availability and permissions. If you need help interpreting an error message or confirming required scopes, contact us at support@orah.com.