OneRoster API Sync allows school districts to automatically "pull" data into TadHealth on a regular schedule. Districts connect their SIS (Student Information System) to TadHealth using the OneRoster API, an industry-standard format for exchanging school roster data. Once connected, TadHealth securely retrieves student, staff, and class data directly from your SIS — no manual file uploads required.

Before you begin: We recommend confirming with your SIS vendor that OneRoster API access is enabled for your district before starting setup.

At minimum, you'll need to enable read permissions to the following items in your SIS's OneRoster API:

Once those permissions are enabled, you'll enter the following connection details into the TadHealth Superuser Portal:

You can save this information and test the connection immediately from the Superuser Portal.

Note for Infinite Campus districts: If you're using Infinite Campus, remove /ims/oneroster/v1p1 from the base URL when copying it over. TadHealth automatically appends this when making API calls.

If you use Aeries, please follow this Aeries guide to set up OneRoster with your SIS.

Once you have your OneRoster URL, Consumer ID, and Consumer Secret Key, enter them into the TadHealth Superuser Portal at:

https://[shortcode].tadhealth.app/super

*Please note that the URL above is unique to your organization. If you are unaware of what your organization's shortcode is please contact us as [email protected]

After entering your connection details, you can save and test the connection directly from the portal to confirm everything is working.

If you run into any issues during setup — or you're using a different SIS and aren't sure where to find these settings — reach out to the TadHealth support team at [email protected] and we'll be glad to help.