Concepts — Objects & Data Model
This section defines the core objects in the Nexus data model. Understanding these objects is essential for working with the API, building integrations, or interpreting the database reference.
Every object in Nexus is scoped to an organization (tenant). Row-Level Security enforces this at the database level.
Object categories
| Category | Key objects | Description |
|---|---|---|
| Contacts & Companies | Contact, Company, Label, Journey Stage | People and businesses you interact with |
| Conversations & Messages | Conversation (Chat), Thread, Message | Omnichannel communication records |
| Orders & Fulfillment | Order, Order Item, Pick List, Shipment (AWB) | Sales and fulfillment lifecycle |
| Inventory & Warehousing | Inventory Item, Warehouse, Bin/Location, Stock Movement | Physical goods tracking |
| Integrations | WhatsApp Credential, Shopify Connection, Meta Page, Courier Config | External service connections |
| Automation | Workflow, Trigger, Action, Automation Rule | Event-driven process automation |
| AI & Analytics | Annotation, Tag, Insight, Risk Flag, CS Metric | AI-powered intelligence layer |