Creating custom events from scratch
Define custom event types in your object-centric data model to capture unique business activities outside standard Celonis catalogs. While the Celonis Object-Centric Data Model (OCDM) provides an extensive catalog of standard event types for common core processes (like Order-to-Cash or Procurement), unique or highly customized source systems often generate specific activities that fall outside these standards.
Creating a custom event allows you to manually model the exact schema shell you need. This is particularly useful when:
You are mapping a completely bespoke in-house application or a niche industry vertical.
You need to capture a specific operational milestone (e.g.,
Quality Gate PassedorDrone Delivery Dispatched) that does not exist in standard templates.You want complete control over custom event attributes before writing the underlying data transformations.
When you model an event from scratch, you are creating its metadata definition. This definition specifies what the event is called, how it is categorized, and what attributes it can hold (such as timestamps, custom IDs, or status strings).
To create custom events from scratch using the Objects and Events dashboard:
Click Events.
Click Create - Model from scratch.
Configure the event type:
Name: Enter a unique name up to 40 characters, using only letters and numbers (no spaces or special characters).
Color: Change the display color used for the event type in the model graph view.
Description: An optional description for this event, visible when viewing the event in the table view only.
Tags: Tags are used to organize, categorize, and filter object types and event types within your object-centric data model. They don’t affect the data itself, they’re purely for management, navigation, and clarity.
Celonis processes: Choose from existing tags used as part of Celonis provided processes.
Custom processes: Enter text to create a new tag, or select an existing one.
Attributes: Configure events attributes to define the properties of an event, choose data types, and enable filtering, grouping, and analysis of your events.
You can choose from the following attribute types: Boolean, datetime, floating point, long integer, and string.
Click Save.
Publish the custom event to the development environment to make it available for data transformations and analysis.