---
title: "Create message business event"
slug: "create-message-business-event"
description: "Set up a message business event in D365 F&SCM to trigger actions based on message runs, ensuring efficient integration and connectivity."
tags: ["Task topic"]
updated: 2026-03-20T12:35:31Z
published: 2026-03-20T17:44:34Z
canonical: "docs.staedean.com/create-message-business-event"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create message business event

If you want to create a business event to be triggered by a message, first create and set up a message business event. A message business event is a business event definition that is used to create a business event in D365 F&SCM.

For each message, you can only create one message business event.

The business event is triggered when the message run is done, taking into account the '**Send business event**' setting.

### Steps

1. Click **Connectivity studio - Integration Design**.
2. On the **Message** tab, in the list, find and select the desired message.
3. Click **Edit**.
4. On the **Action Pane**, click **Design**.
5. Click **Message business event**.
6. Click **New**.
7. The business event ID is composed by a prefix and the target connector type: [prefix]_[target connector type].

You can use the same prefix for several message business events. In this way you can link an existing business event to the message business event.

In this field define the prefix.

In the **Prefix** field, type a value.

> [!NOTE]
> **Note**
> 
> The target connector type as used in the business event ID can be:
> 
> - **D365 F&SCM**: If the target connector is of type '**D365 F&SCM**'.
> - **File**: If the target connector is of type '**Windows folder**' or '**Azure Blob Storage**'.
> - **Database**: If the target connector is of type '**Database**'.
> - **Staging**: If the target connector is of type '**Staging journal**'.

Business events are not supported for target connectors of type '**Web service**' and '**Upload and download**'.
8. Define the name for the business event.

The default name is composed of the project ID and the message ID: [project ID]_[message ID].

You can change the event name as desired.

In the **Event name** field, type a value.
9. Enter a meaningful description for the business event.

The default description of the business event is: "Event triggered after run of message [message ID] of project [project ID]"

You can change the description as desired.

In the **Description** field, type a value.
10. Define when the business event is processed:

In the **Send business event** field, select an option.
  - **Never**: The business event is not processed.
  - **Error**: The business event is only processed if an error occurs during the message run.
  - **Finished**: The business event is only processed if the message has run successfully.
  - **Always**: The business event is processed when the message has run.
11. Sub-task: Define additional content from target document.
  1. You can define additional content from the target document to be sent with the business event.

Expand the **Target field** section.
  2. Click **Add line**.
  3. In the **Response field** field, enter or select a value.
12. Sub-task: Define additional content from source document.
  1. You can define additional content from the source document to be sent with the business event.

Expand the **Source field** section.
  2. Click **Add line**.
  3. In the **Response field** field, enter or select a value.
13. Sub-task: Create Connectivity business event in Business events catalog.
  1. If the message business event definition is set up, create a business event in the Business events catalog. The business event is created based on the message business event definition and gets the category '**Connectivity**'.

Click **Create connectivity events**.

> [!NOTE]
> **Note**
> 
> - If for the message business event the '**Send business event**' field is set to '**Never**', no business event is created.
> - You can view a created '**Connectivity**' business event in the Business events catalog. To do so, on the **Action Pane**, click **Business events catalog**.
14. Close the page.

> [!NOTE]
> **Notes**
> 
> You can also view message business events in these ways:
> 
> - View all message business events for a specific project: On the **Project** page, on the **Action Pane**, on the **Design** tab, click **Message business events**.
> - View all message business events in a D365 F&SCM environment: On the **Connectivity studio** menu, click **Inquiries**, **Message business events**.

## Related

- [Connectivity business event content](/connectivity-business-event-content.md)