School Onboarding (DHE-driven)

Purpose - Lets DHE onboard schools individually or in bulk, and provides the official onboarding Excel template. 

Who Can Use It 

DHE Admin and DHE Employee. 

Key Capabilities 

• Single-School Onboard: submit school name, UDISE code, and email or phone; the system creates a School Admin account and sends an invitation. 
• Bulk School Upload: Excel or CSV file with one or many schools; the system validates each row, sends invitations, and returns non-fatal warnings if some invites fail.
• Download School Onboarding Template: downloadable XLSX template with the expected columns. 
• Get / Update Temp Data: retrieve or partially update a school's pre-approval record kept in DHE-approved school temp data. 
• Search School Admins: paginated search with filters (district, block, UDISE, school name, status, onboarding status). 

How It Works 

• DHE opens the Onboard Schools screen and either uploads the completed template or fills a single-school form. 
• The system validates each row, generates a new school user ID, and dispatches an invitation email or SMS. 
• The school receives the invitation and completes onboarding using the login and password-setup flows. 
  

Rules & Restrictions

• School Name and UDISE Code are required. 
• Either email or phone (or both) is required. 
• Duplicate UDISE codes and duplicate contact details are caught by validation; failing rows are returned as a downloadable errors file. 
• Bulk school upload requires the DHE user to be logged in. 
• Only DHE roles ("dhe", "dheEmployee") can reach the DHE admin routes.