2. Add New Root Tenant

Overview

What	Description
Purpose	Add a new State-level tenant and load master data
Key Rule	You MUST re-authenticate after creating new tenant

Process Flow

---

Step 1: Authenticate Existing Tenant

Field	Example
Gateway URL	https://unified-dev.digit.org
Username	MDMSADMIN
Password	********
Tenant ID	pg (existing tenant)

Click "🔐 Authenticate" → Verify success message

---

Step 2: Create New Root Tenant

Fill the new tenant form:

Field	Example
Tenant Code*	mh
Tenant Display Name*	Maharashtra
Tenant Type*	State
Logo URL*	https://example.com/logo.png

Click “ Create Root Tenant" → Verify tenant created

---

Step 3: Re-Authenticate with New Tenant ⚠️

CRITICAL: You MUST re-authenticate before loading data!

Go back to the Authentication section and change:

Field	Change
Tenant ID	pg → mh

Click " Authenticate" → Verify it shows: Tenant: mh

---

Step 4: Load Master Data

Run all phases for the new tenant:

Phase	What to load	Target tenant
Phase 1	City Tenants + Branding	mh
Phase 2	Boundaries	mh.mumbai, mh.pune
Phase 3	Departments, Complaints	mh.mumbai, mh.pune
Phase 4	Employees	mh.mumbai, mh.pune

---

Common Errors

Key Reminder

⚠️ ALWAYS RE-AUTHENTICATE AFTER CREATING A NEW TENANT

Old: Tenant ID = pg

New: Tenant ID = mh ← Change this before loading data!