Activities Core Concepts

Audience: Technical Builders, Implementors, and Developers

Purpose: Explains how Activities function within Kizen’s data model, so builders can design reliable Agentic Workflows, integrations, and API workflows.

Overview

An Activity represents a human-initiated interaction or a planned touchpoint. Each Activity is an instance of its respective Activity Object, which defines the schema, required fields, and allowed associations for a given Activity type.

Each Activity contains:

• System Fields: Fields that define the Activity’s identity, scheduling, and associations, such as:

  • Activity name (for example, call, meeting, inspection)

  • One or more associated Records (such as a Contact or Object), all Records of an Object type, or no associated Records

  • Timestamps (due_datetime, logged_at)

• Activity Fields: Fields that are defined and stored directly on the Activity Record, including:

  • Notes and descriptions

  • Participants or mentions

  • Categories or tags applied to the Activity

• Custom Fields: Fields that are displayed and editable from the Activity, but whose values are stored on a related Object. These are any Custom Fields configured for the Activity type.

System Behavior

Once an Activity has been created (either logged or scheduled), an Activity:

• Appears on each associated Records Timeline

• Can trigger Agentic Workflows

• Updates reporting datasets

• Is accessible via API, Agentic Workflows, or UI

• Sends webhook events (only when logged)

---

Why Activities Matter

Activities help teams understand the full context of each associated Record, including:

• Shared interaction history: Activities provide a chronological Record of human interactions associated with a Record.

• Clear task management: Scheduled and Logged Activities distinguish to-do tasks from completed tasks.

• Flexible activity tracking: Activities can represent work beyond communication, such as internal tasks, follow-ups, reviews, or reminders, and may be associated with Contacts, Records, or stand alone.

• Standardized engagement data: Activity Objects define consistent schemas for capturing calls, meetings, and other touch points.

• Reliable handoffs: Activities preserve context, outcomes, and ownership so work can continue without reconstruction.

• Agentic Workflow and integration hooks: Activity lifecycle events can trigger Agentic Workflows or external Workflows via APIs and webhooks.

• Reporting and analytics inputs: Activities supply structured engagement data for Dashboards, reports, and operational metrics.

---

Scheduled vs. Logged Activities

A Scheduled Activity represents a human interaction that has not yet occurred or a to-do task, while a Logged Activity represents a completed interaction or task. A Scheduled Activity transitions into a Logged Activity once the task has been completed and the outcome is recorded.

This transition affects how the Activity behaves in the system:

• Scheduled Activities are mutable and used for planning

• Logged Activities are immutable and serve as a historical Record.

Lifecycle transitions can trigger Agentic Workflows, webhooks, and reporting updates. The differences between the two are outlined below.

Attribute	Scheduled Activity	Logged Activity
What it represents	An interaction or task planned for the future	An interaction or task that has occurred
Lifecycle state	Pre-execution	Post-execution
When it's created	Before the interaction or task	After the interaction or task
Primary timestamps	due_datetime	logged_at / completed_at
Mutability	Can be updated, rescheduled, or canceled	Can only be appended to
Timeline behavior	Appears as upcoming	Appears as completed
Agentic Workflow usage	Drives reminders and time-based triggers	Drives completion-based triggers and reporting
State transition	Converts to a Logged Activity when completed	Does not transition to another state
Trigger Webhooks	Cannot trigger webhooks	Can trigger webhooks

---

How Activities are Used

Activities appear across multiple areas of the Kizen platform, allowing the same interaction data to support planning, execution, visibility, and automation.

Calendars

Activities with a scheduled date and time appear on calendars. This helps teams see upcoming tasks, plan capacity, and manage time-based commitments without duplicating data in a separate scheduling system.

Agentic Workflows

Activities can trigger Agentic Workflows or be created by them. This allows workflows to respond to real interactions, such as sending follow-ups after a call is logged or scheduling reminders when an Activity is created. Activity lifecycle events, such as creation, updates, and completion, can trigger Agentic Workflows within Kizen or be consumed via APIs and webhooks by external systems.

Dashboards

Activity data feeds dashboards and reports. Teams can measure volume, timing, completion rates, and outcomes of interactions to understand performance and operational trends.

Timelines

Activities appear in Timelines alongside other relevant events. This gives teams a chronological view of what happened and what’s planned, providing full context for each Contact or Record.

These surfaces reflect Activity data but do not own it. The Activity Record remains the source of truth.

---

Key Use Cases

From a builder or system perspective, Activities support workflows such as:

• Workflow management (sales calls, demos, negotiations)

• Service delivery tracking (on-site visits, inspections, appointments)

• Support processes (case updates, customer follow-ups)

• Compliance workflows (document reviews, required touch points)

• Operational logging (visit logs, check-ins, approvals)

• Engagement-based Agentic Workflows (triggering workflows from Activity events)

Because Activities are exposed through APIs and Agentic Workflows, they function as a shared engagement object across the entire platform.

Industry Examples

Activities are flexible and can support any workflow. These short examples highlight how three different industries use Activities to capture human interactions.

Insurance

Insurance Teams Managing Policyholder Interactions

Insurance workflows use Activities to capture structured Records of every interaction across the policy lifecycle, supporting underwriting, compliance, renewals, and automation.

Examples include:

• Logging an Initial Coverage Consultation documenting coverage needs, risk factors, and existing policies

• Recording a Quote Review Call with pricing options, endorsements, and requested changes

• Logging an Underwriting Follow-Up to track required documents or clarifications

• Scheduling a Policy Renewal Outreach Activity tied to expiration dates and retention workflows

How Activities help:

• Provide a complete, auditable history of policyholder interactions for regulatory and internal review

• Standardize engagement data across agents to ensure consistent policy handling

• Drive Agentic Workflows (e.g., underwriting reminders, renewal notices, lapse prevention workflows)

• Synchronize policyholder interaction data across CRM, underwriting systems, and external platforms via APIs and webhook events

Healthcare

Financial Services

---

What's Next?

Continue to the Activities Data Model to understand how Activities are represented structurally in Kizen, including:

• The core Activity fields and field types

• How Activity Objects define schemas and associations

• How Activities relate to Contacts and other Records

• How Activity data is stored and referenced across the platform

Understanding the data model is essential before working with Activity permissions, APIs, Agentic Workflows, or integrations.

Related Topics

• Activities

• Activities Data Model

• Activity Permissions

• Advanced Activity Rules

• Activities API & Webhooks