Data Model Overview
Create custom objects, fields, and structure your data.
Kantos uses a flexible data model that lets you create custom objects and fields to match your business needs. This guide covers the core concepts, field types, relationships, and best practices for structuring your CRM data.
Flexible by Design
Unlike rigid CRMs that force you into predefined structures, Kantos lets you model your data the way your business actually works. Create any object type, add custom fields, and define relationships that make sense for your workflows.
Core Concepts
Objects
Objects are the building blocks of your CRM. Each object represents a type of data you want to track—like Contacts, Companies, Deals, or any custom entity unique to your business. Think of objects as database tables with a friendly interface.
| Property | Description | Example |
|---|---|---|
| Name | Display name for the object | Contacts, Projects, Vehicles |
| Slug | URL-safe identifier (auto-generated) | contacts, projects, vehicles |
| Icon | Visual identifier in the sidebar | User, Folder, Car |
| Description | Optional explanation of purpose | "People who have contacted us" |
Fields
Fields define what information you store on each object. Every field has a type that determines how data is validated, displayed, and searched. Kantos supports 15+ field types to handle any data structure.
Records
Records are individual entries within an object. For example, each contact in your Contacts object is a record. Records contain field values and metadata like creation date, last modified, and the user who made changes.
Default Objects
Every Kantos organization starts with three built-in objects. These can be customized or hidden, but cannot be deleted:
| Object | Purpose | Default Fields |
|---|---|---|
| Contacts | Individual people you interact with | Name, Email, Phone, Company, Status |
| Companies | Organizations and businesses | Name, Website, Industry, Size, Address |
| Deals | Sales opportunities and pipeline tracking | Name, Value, Stage, Close Date, Contact |
Customize Default Objects
The default objects are just starting points. Add custom fields, rename them, or create entirely new objects that better fit your business model.
API Access
All objects and fields are accessible via the Kantos API. The data model is fully reflected in API endpoints:
# List all objects
GET /api/crm/objects
# Get object schema with fields
GET /api/crm/objects/{object_id}
# Query records
GET /api/crm/records/query?object_id={object_id}
# Create a record
POST /api/crm/record
{
"object_id": "obj_contacts",
"field_values": {
"name": "John Doe",
"email": "john@example.com",
"company": "rec_company_123"
}
}Next Steps
- Custom Objects — Create and configure custom objects
- Field Types — Explore all available field types
- Relationships — Connect objects with lookups, formulas, and rollups
- Import & Export — Bring data in and out of Kantos
- API Reference — Programmatically manage objects and records