A Message Start Event starts a process automatically when a defined message is received from an external system.
In BPMN, this event represents an external trigger, such as an API call, incoming request, or integration event. The process begins only when the message matches the configured definition.
Message start events begin a process instance when a named message is received.
Use a Message Start Event when:
- A process must start in response to an external system or user action.
- The trigger is a clearly defined message, such as a request, event notification, or API call.
- You need to integrate process execution with other applications or services.
To use a Message Start Event, you must define a message. Only messages that meet the defined criteria will start the process.
Messages are managed within the project and can be reused across processes. Data from the incoming message can be mapped to process variables, depending on mapping (see Mapping Process Variables).
If no mapping is defined, message data is not automatically stored for later use.
Do not use this event for manual or form-based starts. In those cases, use a generic Start Event instead.
For example, in an order processing scenario, an external system sends a message when a new order is created. The Message Start Event receives the message that matches the configured criteria. A new process instance starts to handle the order.