Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Matrix API Application Server

Security covered Under active development

This module integrates Drupal with a Matrix homeserver as an Application Service, allowing it to receive all events across all rooms and users without joining them. It can also create virtual Matrix users, enabling each Drupal user to have a unique Matrix identity and facilitating bridge-style integrations and large-scale deployments.

Drupal's Matrix API module connects to a Matrix homeserver as a regular bot user — joining rooms, sending messages, and polling for new events. That works well for many use cases, but a bot user has inherent limits: it must be invited to each room individually, it can only see events in rooms it has joined, and it cannot act as or create other Matrix users.

This module lifts those limits by implementing the Matrix Application Service protocol. An Application Service (AS) is registered directly with the homeserver and receives a push of every event — across all rooms, all users, and all event types — without joining anything. It can also create and manage a namespace of virtual Matrix users that appear to the rest of the network as real accounts on the homeserver.

Features

  • Exposes the AS /_matrix/app/v1/transactions endpoint so the homeserver can push event batches to Drupal in real time — no polling required
  • Manages the hs_token / as_token credential handshake that authenticates traffic between the homeserver and Drupal in both directions
  • Generates the Application Service registration YAML that your homeserver operator adds to homeserver.yaml (Synapse) or equivalent
  • Enables virtual user provisioning: Drupal can create Matrix users on behalf of site accounts, so each Drupal user can have a corresponding Matrix identity rather than all messages appearing to come from a single bot
  • Handles the AS namespace configuration (user namespace, room namespace, alias namespace) so only the events relevant to your integration are pushed
  • Suitable for bridge-style integrations, multi-room monitoring, and large deployments where inviting a bot to every room is not practical

Post-Installation

After enabling the module, go to Admin → Configuration → Services → Matrix Application Server to configure your user and room namespaces and generate the registration file. Provide that YAML file to whoever administers your Matrix homeserver — it must be added to the server configuration and the homeserver restarted before events will flow. Once registered, inbound events arrive at Drupal in real time rather than on a cron schedule. YAML file is formatted and tested with a Matrix Synapse homeserver - other homeservers may require different configurations.

Additional Requirements

matrix_api. Administrative access to your Matrix homeserver is required to register the Application Service — this is a server-side configuration step that cannot be done from within Drupal alone. Self-hosted Synapse, Conduit, Dendrite, and most other homeserver implementations support the Application Service protocol.

- matrix_api_identity — map virtual Matrix users to Drupal accounts
- matrix_api_entity — sync Drupal content entities with Matrix room threads

Ask your assistant about Matrix API Application Server

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
2
Tracked since
Oct 2026
Latest release
5 days ago
Releases (12 mo)
2 ▲ from 0
Maintenance
Active

Releases

Version Type Core PHP Release date
1.0.0-alpha1 Pre-release 11 Nov 17, 2026
1.0.x-dev Dev 11 Oct 7, 2026