Skip to content

Event Tables

Event Tables is where you pick which Business Central tables publish events, which fields go into each event's JSON payload, and which event types actually fire. Open it from Event Bridge Setup's Event Tables action, or search Business Central for Event Tables.

Event Tables list showing Customer, Item, Project, and Vendor registered with different event types turned on

Add a table

  1. On Event Tables, choose Add Table.

  2. Search for the table you want to publish events for (e.g. "Customer", "Sales Header") and select it — double-click a row, or check several and choose Add Table to add multiple at once.

    Select Event Table dialog listing tables like Location, G/L Account, and Customer to add

    Expected result: the table appears in the list with 0 Active Fields and every event type unchecked. No events are sent yet — you still need to add fields and turn on at least one event type below.

Add fields to the payload

  1. Drill down on the table's name in Event Tables to open its Event Card.
  2. In the Fields part, choose Add Field.
  3. Select the fields to include — the list shows each field's number, name, caption, type, whether it's part of the primary key, and its relation table if it has one. Primary key fields and FlowFields are visually highlighted so you can spot them at a glance. Choose Add Field to add your selection.

Each added field gets a Key Name — the property name it appears under in the JSON payload — generated automatically from the field's caption (letters, digits, underscore, and hyphen only). Rename it if you want a different JSON key; names must stay unique within that table's event and can only use those same characters.

Some fields point at another table's primary key (visible as a Relation Table Name in the field picker) — for those, you can pull in fields from the related record too, not just the key itself.

  1. On a field that has a relation, choose Add Related Field.

  2. Pick fields from the related table the same way as adding fields above.

    Expected result: the related fields appear indented underneath their parent field in the list, and nest under that field's key in the JSON payload — e.g. fields added under a "Sell-to Customer No." relation appear nested under that field's key, not flattened alongside it. Check the exact shape with Message Preview.

Related fields are looked up live, by matching the parent field's current value against the related table's primary key at the moment the event fires — they aren't stored redundantly. If no matching record exists at that moment, the nested key is simply left out of the payload rather than sent empty.

Event Card for the Project table with Bill-toCustomerNo's related No./Name/SearchName fields nested underneath it

Turn on event types

In the Event Card's Registered Events group, turn on any combination of:

  • Insert Event — a new record was created.
  • Modify Event — an existing record changed.
  • Rename Event — a record's primary key changed.
  • Delete Event — a record was deleted.

You need at least one field added before any of these take effect. If fields exist but no event type is turned on, Business Central shows a reminder notification right on the card. Conversely, removing every field from a table automatically turns all four event types back off.

Include Previous Values (only relevant when Modify or Rename is on) controls whether those events include a before/after comparison of every field's value, or just the current (after) values on their own — comparison payloads are roughly double the size, so leave it off if your integration doesn't need to see what changed, only that it did.

Filter which changes get published

Insert Filter and Modify Filter on a field (first-level fields only — not related/detail fields, and not Media/MediaSet fields) restrict when that event type fires, using standard Business Central filter syntax (e.g. >100, A|B, <>'') evaluated against that field's value at the moment of the event.

If you set filters on more than one field, all of them must match — they combine as AND, not OR. A table with no filters set at all always fires its events, unfiltered.

Use Message Preview to check whether a specific record currently passes your filters (shown as ✅/❌) before relying on them in production.

Remove a table or field

  • Delete a line in the Fields part to stop sending that field — any related fields nested under it are removed along with it.
  • Delete a table from Event Tables to stop publishing events for it entirely, including all of its configured fields.