BeyondERP.Newsletter
Menu

Setup step on the Business events parameters page · System administration

Set up Business events parameters

Use this page to tune retries, endpoint limits and the threads that send business events.

Used by
Business events security role
Business process
Administer system features
Menu item
BusinessEventsParameters
Main table
BusinessEventsParameters
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page with the general, performance, Event Grid and HTTPS settings that apply to all business events.
What you do hereUse this page to tune retries, endpoint limits and the threads that send business events.
ExampleFor example, with Retry count 3 and Wait time between retries 1,000 milliseconds, an event that can't reach a BEAT endpoint is tried again three times and then appears on the Errors tab of the catalog, where it can be resent after the endpoint is fixed.
Business events parameters page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Setup › Business events › Business events parameters
Set up firstFeature management (Business events catalog security) Microsoft Learn
Used next byBusiness events catalog Microsoft Learn
Related pagesServer configuration (shared batch capacity) Microsoft Learn
In this process Set up Units · Set up Calendars
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Business events parameters1 screen

Use this page to tune retries, endpoint limits and the threads that send business events.

  1. Screen 1

    Review the business events parameters

    Go to System administration > Setup > Business events > Business events parameters

    1. Open the General tab and review the retry count, the wait time between retries and the endpoints allowed per event
    2. Open the Performance tab to review the threads that send business events
    3. Select Restore default settings to return to the delivered values
    Review the business events parameters (zoomed on the outlined fields)
    Show the full screenReview the business events parameters
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to System administration > Setup > Business events > Business events parameters.
  2. On the General tab, set Retry count, Wait time between retries (milliseconds), Endpoints allowed per event and Key vault secret cache interval (minutes).
  3. Select Restore default settings to go back to the default values.
  4. Select the Performance, Event Grid settings or HTTPS settings tab to set those options.
  5. Select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Retry countHow many times the system tries again to send an event after an error (default 3).Microsoft Learn EndpointRetryCount
Wait time between retriesThe pause between attempts, in milliseconds (default 1,000).Microsoft Learn
Endpoints allowed per eventThe most endpoints that can subscribe to one event in a legal entity (default 10).Microsoft Learn EndpointsPerEvent
Key vault secret cache intervalHow many minutes Key Vault secrets are kept in memory before they are read again.Microsoft Learn
Processing threadsHow many threads process business events, per batch server (maximum 4).Microsoft Learn
Bundle sizeHow many events a thread processes together.Microsoft Learn BundleSize
Send object in Event Grid data fieldSends the payload to Azure Event Grid endpoints as an object instead of a JSON string.Microsoft Learn SendObjectInEventGridData
HTTP timeout (milliseconds)How long the HTTPS adapter waits for an endpoint; 0 means the 10-second default.Microsoft Learn HttpTimeoutInMilliseconds

Common errors and fixes

MessageWhat to do
An event appears on the Errors tab after all retriesFix the endpoint, then use Resend on the error. Raise Retry count or Wait time between retries only if the endpoint is often briefly unavailable. Microsoft Learn

Test checklist

  1. Create an endpoint and activate one business event (for example a purchase order confirmed event) for a legal entity.
  2. Trigger the business process and check the event reaches the endpoint.
  3. Disable the endpoint target and trigger again; check the event appears on the Errors tab after the retries.
  4. Fix the endpoint and use Resend on the error; check it is delivered.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Business events parametersKeep the defaults (Retry count 3, Wait time between retries 1,000 ms, Endpoints allowed per event 10, Key vault secret cache interval 5 minutes, HTTP timeout 0 = 10 seconds) and change Processing threads (maximum 4) only after measuringProcessing threads come from the shared batch capacity, so Microsoft asks for care when changing them. Bundle size trades parallel processing against overhead on small bundles.Are the business events retry and thread settings changed from the defaults?Using business events to export data. Microsoft says business events must stay lightweight and are not a data export mechanism.Test: Failed business event retries and lands in the error log

Feature management and licence

Feature to turn onBusiness events catalog security (Optional)

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: the same records are used by every legal entity. Microsoft data model
Can it be undoneReversible: Parameters can be changed at any time and apply to event processing from then on.
If you change it laterBusiness event threads come from the shared batch capacity, so changing them affects other batch processing. Microsoft Learn
Technical architect

6Technical

Menu itemBusinessEventsParameters Checked in Dynamics 365
FormBusinessEventsParameters Checked in Dynamics 365
TableBusinessEventsParametersShown as “Business events parameters” in Record infoChecked in Dynamics 365
Who can open itPrivilegesBusiness events security privilege BusinessEventsSecurityPrivilegeDutiesBusiness events security duty BusinessEventsSecurityDuty
1 security roleBusiness events security role BusinessEventsSecurityRole
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itBusiness events security role BusinessEventsSecurityRoleGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, Edit, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=BusinessEventsParameters
Data migrationLoad order: Business events parameters has no data entity in Data management, so it can't be loaded from a file or a configuration template. Keep the defaults or enter the values by hand in each environment; Restore default settings brings back Microsoft's values.Checked in Dynamics 365
Table definitionBusinessEventsParameters columns and relations Microsoft data model
Everyone

8Sources

To cite this step: SA-SETUP-250, Set up Business events parameters. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SA-SETUP-250