User GuideEntity Management
Tenants
Understanding tenant organizations in SuitePortal
Tenants
In SuitePortal, a tenant is a primary organization that owns a NetSuite integration. Tenants are not synced from NetSuite—they are created in SuitePortal when you sign up.
Tenant vs Other Entity Types
| Type | Source | Description |
|---|---|---|
| Tenant | SuitePortal | Your primary organization (created on sign-up) |
| Customer | NetSuite sync | Customer records from NetSuite |
| Vendor | NetSuite sync | Vendor records from NetSuite |
| Employee | NetSuite sync | Employee records from NetSuite |
| Contact | NetSuite sync | Contact records from NetSuite |
Tenant Organization Properties
| Property | Type | Description |
|---|---|---|
id | string | Unique organization ID |
name | string | Organization display name |
slug | string | URL-friendly identifier |
portalType | "tenant" | Always "tenant" for primary orgs |
tenantId | string | Identifier used for data isolation |
subscriptionTier | enum | basic, premium, or enterprise |
Data Isolation
The tenantId is used throughout the system for data isolation:
- Sync configurations are scoped to
tenantId - Synced records are tagged with
tenantId - API requests are filtered by
tenantId - Child organizations (customer/vendor) inherit the parent's
tenantId
Child Organizations
A tenant can have child organizations:
| Child Type | portalType | Linked Field |
|---|---|---|
| Customer Portal | customer | customerId → NetSuite customer ID |
| Vendor Portal | vendor | vendorId → NetSuite vendor ID |
Child organizations have:
parentfield set to tenant organization ID- Access only to their own data (row-level security)
Viewing Your Tenant
- Navigate to Settings → Organization
- View tenant details and configuration
Tenant Settings
Configure your tenant organization:
| Setting | Description |
|---|---|
| Name | Organization display name |
| Logo | Branding image |
| Primary Color | Theme color |
| NetSuite Integration | Connection settings |
| Members | Team member management |
| Billing | Subscription and usage |
Multi-Tenant Architecture
SuitePortal uses multi-tenancy to isolate data:
Tenant A (tenantId: ACCT_123)
├── Customers (filtered by tenantId)
├── Orders (filtered by tenantId)
└── API Keys (scoped to organization)
Tenant B (tenantId: ACCT_456)
├── Customers (isolated from Tenant A)
├── Orders (isolated from Tenant A)
└── API Keys (scoped to organization)Creating Additional Organizations
To create customer or vendor portal organizations, sync customer/vendor records from NetSuite. SuitePortal automatically creates linked organizations.