--- title: Rotate API credentials description: Replace the Client ID, Client Secret, or Service URL on a SchoolDay API integration, test the connection, and confirm the next sync succeeds. --- [Skip to content](https://help.schoolday.com/knowledge/rotate-api-credentials#main-content) English Show submenu for translations [More support](https://help.schoolday.com/knowledge/kb-tickets/new?hsLang=en) [Customer portal](https://help.schoolday.com/support?hsLang=en) ![gg4l logo](https://help.schoolday.com/hs-fs/hubfs/Automated%20emails/gg4l%20logo.png?width=100&height=33&name=gg4l%20logo.png) - [Go to Knowledge Base](https://help.schoolday.com/knowledge) Open main navigation Close main navigation - [Go to Knowledge Base](https://help.schoolday.com/knowledge) - English Show submenu for translations - [More support](https://help.schoolday.com/knowledge/kb-tickets/new) - [Customer portal](https://help.schoolday.com/support) What are you looking for? - There are no suggestions because the search field is empty. 1. [SchoolDay Help Center](https://help.schoolday.com/knowledge?hsLang=en) 2. [Roster Integrations](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en) 3. [API Integration](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#api-integration) November 7, 2026 # Rotate API credentials ## Replace the Client ID and Client Secret on a live API integration without losing roster data, and keep the gap in scheduled syncs as short as possible. **In this article** > [Requirements](https://help.schoolday.com/knowledge/rotate-api-credentials#requirements) > > [Step 1: Get the new credentials from your SIS](https://help.schoolday.com/knowledge/rotate-api-credentials#step-1-get-the-new-credentials-from-your-sis) > > [Step 2: Update the integration in SchoolDay](https://help.schoolday.com/knowledge/rotate-api-credentials#step-2-update-the-integration-in-schoolday) > > [Step 3: Run a sync](https://help.schoolday.com/knowledge/rotate-api-credentials#step-3-run-a-sync) > > [Verify the rotation](https://help.schoolday.com/knowledge/rotate-api-credentials#verify-the-rotation) > > [Troubleshooting](https://help.schoolday.com/knowledge/rotate-api-credentials#troubleshooting) > > [Next steps](https://help.schoolday.com/knowledge/rotate-api-credentials#next-steps) Rotate credentials when your student information system (SIS) issues a new Client Secret, when a secret is exposed, or when your district rotates API credentials on a schedule. The integration keeps its mappings, filters, and history. Only the connection details change. ### Requirements - Primary District Admin permissions in SchoolDay. - Administrator access to the SIS that issues the credentials. - The new credentials, or the ability to generate them. - A time when no sync is running. Check the **History** tab before you start. **Important:** Scheduled syncs fail while the stored credentials are invalid. Complete all three steps in one sitting. Don't generate new credentials now and update SchoolDay later. ### Step 1: Get the new credentials from your SIS 1. Sign in to your SIS as an administrator. 2. Open the application entry for SchoolDay: - In Infinite Campus, go to **Instruction** \> **Settings** \> **Digital Learning Application Configuration**. - In PowerSchool, go to **System Management** \> **Server** \> **Plugin Management Configuration**, open the **SchoolDay Data Sync** plugin, then select **Data Provider Configuration**. See PowerSchool: Get OAuth Credentials. - For every other SIS, see the setup article for your SIS in [Import data via API integration](https://help.schoolday.com/knowledge/import-data-via-api-integration?hsLang=en). 3. Regenerate or copy the Client ID and Client Secret. 4. Check whether the Service URL or authentication URL changed. Regenerating a secret usually leaves both unchanged. **Important:** Copy the secret before you leave the page. Most SISes show it only once. ### Step 2: Update the integration in SchoolDay 1. Sign in to SchoolDay. 2. Go to **Connect** and select the application. 3. Go to **Settings** \> **Delivery Config**. 4. Replace the Client Secret. If the Client ID, Service URL, or authentication URL changed, replace those too. 5. Click **Test Connection**. 6. If the test succeeds, save the configuration. If the test fails, don't save. Check the values you entered against the SIS, then test again. See the Troubleshooting section. ### Step 3: Run a sync 1. Go to **Connect** and select the application. 2. Click **Run Import**. For a 2-way sync application, click **Run Sync**. 3. Wait for the run to finish. Running a sync now confirms the new credentials work with a full import. If you wait for the next scheduled run instead, a failure might go unnoticed until after hours. ### Verify the rotation 1. Confirm the application status is **Active**. 2. Open the **History** tab and click **Show Details** on the run you started. Confirm it finished and the record counts match your previous successful run. 3. After the next scheduled run, check the **History** tab again and confirm that run finished too. To see when it's due, go to **Settings** \> **Schedule**. See [Set up a sync schedule](https://help.schoolday.com/knowledge/sync-schedule?hsLang=en). The rotation is complete when the status is **Active** and two consecutive runs finish without connection errors. ### Troubleshooting | **Symptom** | **Likely cause** | **Fix** | | --- | --- | --- | | **Test Connection** fails right after the update | The secret was copied with leading or trailing spaces, or you replaced the wrong field. | Copy the secret from the SIS again and paste it. Confirm the Client ID matches the same SIS application. | | **Test Connection** fails and the SIS shows no application | The application entry was deleted in the SIS instead of having its secret regenerated. | Recreate the application entry in the SIS, then update every connection field in **Delivery Config**, not only the secret. | | Status stays **Connection failed** after a successful test | The configuration wasn’t saved. | Go back to **Settings** \> **Delivery Config**, confirm the new values are there, and save. | | The sync succeeds but the record count drops sharply | The new SIS application has a narrower scope than the old one. | Check which schools and record types the SIS application is authorized for, then run the import again. | | The run is held for approval | The Safety Threshold treated the volume of changes as significant. | Review the changes on the **History** tab and accept them if you expect them. See [Safety Threshold: protect against unexpected bulk changes](https://help.schoolday.com/knowledge/safety-threshold?hsLang=en). | ### Next steps - [Import data via API integration](https://help.schoolday.com/knowledge/import-data-via-api-integration?hsLang=en) - [Troubleshoot roster data sync issues](https://help.schoolday.com/knowledge/troubleshoot-sync-issues?hsLang=en) - [Set up a sync schedule](https://help.schoolday.com/knowledge/sync-schedule?hsLang=en) - [Check data quality after each sync](https://help.schoolday.com/knowledge/check-data-quality?hsLang=en) - [Getting Started](https://help.schoolday.com/knowledge/getting-started?hsLang=en#main-content) - [Introduction](https://help.schoolday.com/knowledge/getting-started?hsLang=en#introduction) - [Getting Started by Role](https://help.schoolday.com/knowledge/getting-started?hsLang=en#getting-started-by-role) - [Get Support](https://help.schoolday.com/knowledge/getting-started?hsLang=en#get-support) - [Legal](https://help.schoolday.com/knowledge/getting-started?hsLang=en#legal) - [Data Management (Connect)](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#main-content) - [Introduction](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#introduction) - [Applications](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#applications) - [Data Mapping](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#data-mapping) - [Data Synchronization](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#data-synchronization) - [Data-Sharing Requests](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#data-sharing-requests) - [Data Quality](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#data-quality) - [Data Privacy (Privacy Shield)](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#data-privacy-privacy-shield) - [Grade Sync Service](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#grade-sync-service) - [Miscellaneous](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#miscellaneous) - [Governance](https://help.schoolday.com/knowledge/data-management-connect?hsLang=en#governance) - [Roster Integrations](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#main-content) - [Introduction](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#introduction) - [SFTP Integration](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#sftp-integration) - [API Integration](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#api-integration) - [Import Integrations](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#import-integrations) - [PowerSchool Integration](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#powerschool-integration) - [Export Integrations](https://help.schoolday.com/knowledge/roster-integrations?hsLang=en#export-integrations) - [Administration & Account Settings](https://help.schoolday.com/knowledge/administration-account-settings?hsLang=en#main-content) - [Account Settings](https://help.schoolday.com/knowledge/administration-account-settings?hsLang=en#account-settings) - [Organization Management](https://help.schoolday.com/knowledge/administration-account-settings?hsLang=en#organization-management) - [SSO](https://help.schoolday.com/knowledge/sso?hsLang=en#main-content) - [Introduction](https://help.schoolday.com/knowledge/sso?hsLang=en#introduction) - [Identity provider (IdP) Setup](https://help.schoolday.com/knowledge/sso?hsLang=en#identity-provider-idp-setup) - [SSO Applications](https://help.schoolday.com/knowledge/sso?hsLang=en#sso-applications) - [SSO Resources](https://help.schoolday.com/knowledge/sso?hsLang=en#sso-resources) - [MFA for Administrators](https://help.schoolday.com/knowledge/sso?hsLang=en#mfa-for-administrators) - [MFA for Users (SchoolDay Login)](https://help.schoolday.com/knowledge/sso?hsLang=en#mfa-for-users-schoolday-login) - [ID Card Login](https://help.schoolday.com/knowledge/sso?hsLang=en#id-card-login) - [SSO Troubleshooting](https://help.schoolday.com/knowledge/sso?hsLang=en#sso-troubleshooting) - [LMS Integrations](https://help.schoolday.com/knowledge/lms-integrations?hsLang=en#main-content) - [Coursera Integration Video Guides](https://help.schoolday.com/knowledge/lms-integrations?hsLang=en#coursera-integration-video-guides) - [Coursera Platform Integration](https://help.schoolday.com/knowledge/lms-integrations?hsLang=en#coursera-platform-integration) - [Qwiklabs Platform Integration](https://help.schoolday.com/knowledge/lms-integrations?hsLang=en#qwiklabs-platform-integration) - [LMS Integrations instructions](https://help.schoolday.com/knowledge/lms-integrations?hsLang=en#lms-integrations-instructions) - [Resource Management (App Store)](https://help.schoolday.com/knowledge/resource-management-app-store?hsLang=en#main-content) - [Users & Classes](https://help.schoolday.com/knowledge/resource-management-app-store?hsLang=en#users-classes) - [Resources](https://help.schoolday.com/knowledge/resource-management-app-store?hsLang=en#resources) - [Access & Security](https://help.schoolday.com/knowledge/resource-management-app-store?hsLang=en#access-security) - [Privacy Governance Console (PGC)](https://help.schoolday.com/knowledge/privacy-governance-console-pgc?hsLang=en#main-content) - [Get Started](https://help.schoolday.com/knowledge/privacy-governance-console-pgc?hsLang=en#get-started) - [Monitor and Report](https://help.schoolday.com/knowledge/privacy-governance-console-pgc?hsLang=en#monitor-and-report) - [Govern Apps](https://help.schoolday.com/knowledge/privacy-governance-console-pgc?hsLang=en#govern-apps) - [For Parents/Students](https://help.schoolday.com/knowledge/for-parents-students?hsLang=en) - [For Vendors](https://help.schoolday.com/knowledge/for-vendors?hsLang=en) - [Updates](https://help.schoolday.com/knowledge/updates?hsLang=en#main-content) - [2026](https://help.schoolday.com/knowledge/updates?hsLang=en#2026) - [2025](https://help.schoolday.com/knowledge/updates?hsLang=en#2025) - [2024](https://help.schoolday.com/knowledge/updates?hsLang=en#2024) - [2023](https://help.schoolday.com/knowledge/updates?hsLang=en#2023) - [2022](https://help.schoolday.com/knowledge/updates?hsLang=en#2022) - [Reference](https://help.schoolday.com/knowledge/reference?hsLang=en#main-content) - [APIs](https://help.schoolday.com/knowledge/reference?hsLang=en#apis) - [CSV File Formats](https://help.schoolday.com/knowledge/reference?hsLang=en#csv-file-formats) [![SchoolDay logo](https://help.schoolday.com/hs-fs/hubfs/schoolday-logo%20(300%20x%20100%20px)%20(1).png?width=300&height=100&name=schoolday-logo%20(300%20x%20100%20px)%20(1).png "SchoolDay logo")](http://schoolday.com) [mailto:support@schoolday.com](mailto:support@schoolday.com) Copyright © 2025, SchoolDay, Inc.