Configure a Bridge with HTTP

Last modified: September 15, 2026

Introduction

An HTTP bridge is a one-way bridge that uses HTTP requests to send events from external systems to the Mendix Event Broker.

HTTP Bridge Headers

HTTP bridges require specific headers for authentication. Authorization must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: Authorization: Bearer <your-personal-access-token>

For details on how to obtain your Bearer token, see the Using the HTTP Bridge section below.

Optional Headers

You can include additional HTTP headers in your request to provide event metadata, such as:

  • ce_time – sets the published time of the event; for example: 2025-06-13T15:36:52.148542+02:00

All custom HTTP headers are forwarded as Kafka headers by default.

Using the HTTP Bridge

To run the HTTP bridge from your client, include a Bearer token in the request header.

  1. Open the HTTP bridge details using the Options ( ) menu on the Overview page.
  2. Add the Bearer token.

Configure Service

  1. Configure the service by filling out the following:

    • Event Broker Space – the space where the bridge will operate
    • Name – the name you want to call the bridge
    • AWS region – the AWS region where your bridge operates

  2. Click Next to connect events to your bridge.

Connect Events

To connect business events to the HTTP bridge, follow these steps:

  1. Click Add Business Events to open a dialog box that displays all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events that can subscribe appear, as this bridge operates in one direction.

  2. Select the events to integrate. After selecting events, the bridge automatically generates the URL for the HTTP connection.

  3. Click Next to proceed to the confirmation screen.

Editing Bridges

You can edit an HTTP bridge to modify the configuration as your integration requirements evolve, without recreating it. For an HTTP bridge, you can add or remove Business Events.

To edit a bridge:

  1. On the Event Broker Manager page, navigate to the Event Broker Bridges tab.

  2. Click the bridge you want to modify.

  3. Click Edit to enter editing mode. In editing mode, you can perform the following actions:

    • Add Business Events:

      1. Click Add Business Events to open a dialog box that displays available events.
      2. Select the events you want to add and click Select. Added events display an Added badge and can be removed before applying changes.

    • Remove Business Events:

      1. Navigate to the event you want to remove and click Remove. Removed events display a Removed badge, and their name and metadata appear grayed out.
      2. Re-add a removed event by clicking Add before applying changes.

  4. After you make your changes, you can:

    • Click Apply to save and apply the changes. A confirmation message indicates whether the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status changes to Reconfiguring and returns to Running when reconfiguration is complete.
    • Click Cancel to exit editing mode without saving any changes.