1. Login & Add Tenant

Overview

This step connects the notebook to your CMS environment. It also creates your first root tenant (top-level tenant).

You’ll need

• A running data loader notebook for CMS.
• Default admin credentials from your deployment.
• Your tenant identifiers (example: state pg, city pg.citya).

1.1 Login

Run the login() cell. Use an admin user that has SUPERUSER.

1.2 Create a root tenant

Run the create_tenant() cell. Fill these fields:

• Tenant code / tenantId: short, unique code. Example: pg.
• Name: internal name. Example: Punjab.
• Display name: UI label. Example: Government of Punjab.
• Users: at least one admin user for the new tenant.

Roles matter for what you can do next. Minimum: SUPERUSER for creating root tenants. Recommended for end-to-end testing and demos:

["SUPERUSER", "EMPLOYEE", "CSR", "GRO", "DGRO", "PGR_LME", "PGR_VIEWER", "CITIZEN"]

Notebook cells for login and tenant creation.

1.3 Run the cells

Press Shift + Enter. Run login() first. Then run create_tenant().

1.4 Verify results

If all goes well, you should see the following notifications.