Homeroom can sync student, parent, and family data from your school's Veracross SIS, and pull each day's attendance so you know who is absent before your activities start.
Veracross setup works a little differently from other integrations. Veracross issues API credentials to Homeroom through its Partner Portal, so instead of connecting from inside Homeroom, you authorize Homeroom in Veracross and we finish the connection on our side.
There are three parts:
In Veracross you add Homeroom as an integration partner and approve the data we can read.
Homeroom picks up the credentials and turns the integration on for your school.
In Homeroom you choose what syncs.
Before you start
You will need:
The OAuth_App_Admin role in Veracross. Only a user with this role can add an integration partner. If you are not sure who has it, check with whoever manages your Veracross security roles.
Admin access in Homeroom for your school.
Step 1: Add Homeroom as an integration partner in Veracross
Sign in to Axiom and go to the Identity & Access Management homepage: https://axiom.veracross.com/#/homepage/iam
Click Add Integration Partner, then Add New Partner at the bottom of the list.
Fill in the partner details:
Description: Homeroom data sync
Contact name: Homeroom integration team
Contact email: support@homeroom.com
Save the partner record, then click Start Integration and Add OAuth Application.
Veracross will send Homeroom an invitation to your Partner Portal, where we pick up the credentials. You never need to email us a client ID or secret.
Step 2: Approve the scopes Homeroom needs
On the OAuth Application you just created, approve the scopes below. Homeroom can only read what you approve here, and the sync will fail on anything that is missing.
Required for student and family sync
households:list
households:read
parents:list
parents:read
students:list
students:read
emergency_contacts:list
Required for attendance sync
master_attendance:list
All of these are read-only. Homeroom does not write anything back to Veracross.
Step 3: Homeroom enables the integration
Once the OAuth Application exists and Homeroom has the credentials, we enable Veracross for your school and let you know. This usually takes about a business day.
After that, a Veracross tab appears under Setup > Integrations in Homeroom. If you do not see it, the connection is not live yet, so reach out to your Homeroom contact.
Step 4: Choose what syncs
Open Setup > Integrations > Veracross. There are three panels.
Sync configuration
Turn on Enable Veracross Sync. This starts the nightly pull of students, parents, households, and emergency contacts. Nothing syncs until this is on.
Turning sync off does not affect Veracross SSO login. They are separate.
School level filtering
Choose which Veracross school levels (Lower School, Middle School, and so on) sync into this Homeroom school.
Leave everything unchecked to sync all students.
School levels only appear here after the first sync has run, so if the list is empty, check back the next day.
Attendance sync
Choose whether Homeroom pulls attendance from Veracross:
Off means no attendance is pulled.
Sync most recent before Homeroom activities begin (recommended) uses each student's Veracross attendance status for the day.
Continue syncing during activities keeps checking Veracross attendance until your Homeroom activities end. Use this if your school day and your Homeroom activities overlap and attendance can change after activities start.
If attendance sync is on, you also choose what happens when a student has no Veracross attendance record for the day:
Ignore (recommended) means the student is skipped and their Homeroom attendance is left alone.
Mark absent means the student is marked absent.
Most schools should use Ignore. Veracross typically only creates a record when something is unusual, so no record usually means the student was in school.
Save each panel after you change it.
What syncs, and when
Students, parents, households, and emergency contacts refresh once a night.
Attendance is checked throughout the day and applied to that day's activities.
Students who have left the school (they have an exit date in Veracross) stop syncing.
Veracross statuses map to Homeroom like this: Absence and Early Dismissal mark the student absent, Present and Tardy leave them present.
If Homeroom marked a student absent from Veracross and Veracross later shows them present, Homeroom clears that absence. Absences your staff entered by hand are never overwritten.
Turning it off
Go to Setup > Integrations > Veracross and turn off Enable Veracross Sync. That stops all syncing and leaves your existing Homeroom data in place. To fully revoke Homeroom's access, remove the OAuth Application from the partner record in Axiom.
Troubleshooting
No Veracross tab in Homeroom means the connection is not live yet. Contact Homeroom.
The tab is there but nothing syncs means Enable Veracross Sync is probably off. Data lands the morning after you enable it.
Some students are missing means school level filtering is likely on. If any level is checked, only those levels sync.
School levels list is empty means the first sync has not run yet. Check back the next day.
Attendance is not updating means either attendance sync is set to Off, or the master_attendance:list scope was not approved on the OAuth Application in Axiom.