---
title: "Integrations - Matrix"
url: "https://docs.unified.to/integrations/matrix"
description: "Build Matrix integrations faster with our Unified API — Messaging data, API key, real-time sync."
date: "2026-11-11T18:29:28.283Z"
updated: "2026-11-11T18:29:28.283Z"
---

# Matrix integration

> What this integration supports through the Unified.to API, by object. Live data: `GET https://api.unified.to/unified/integration?type=matrix` with your workspace API key (or Core MCP `list_unified_integrations` with `type: "matrix"`). All integrations: https://docs.unified.to/integrations.md

## Overview

- **Type:** `matrix`
- **Categories:** [Messaging](https://docs.unified.to/messaging/overview.md), [Passthrough](https://docs.unified.to/passthrough/overview.md)
- **Website:** https://matrix.org
- **Vendor API docs:** https://spec.matrix.org/v1.13/client-server-api/
- **Launched:** 2026-11-10

## How end users connect

- **API key** entered by the end user: `Access Token`, `Homeserver Host`
    - A Matrix access token for the account Unified acts as (a bot or service account is recommended). Get one with POST /_matrix/client/v3/login, or in Element under Settings → Help & About → Advanced → Access Token. The token acts as its user, so the account must have joined the rooms you want to read.
    - The host of your homeserver, e.g. matrix.org or matrix.example.com (no https:// and no /_matrix path).

## Supported objects

| Object | Methods | Webhooks |
| --- | --- | --- |
| [messaging_channel](#messaging_channel) | list, create | none |
| [messaging_message](#messaging_message) | list, get, create, remove | none |
| [passthrough](#passthrough) | none | none |

Values below come from the integration's support data. "Required list filters" must be sent on list calls; "Required on create" fields must be sent when creating. Webhook events are `native` (pushed by the vendor) or `virtual` (polled by Unified.to). Anything not listed is not supported; an unsupported method returns `501`.

### messaging_channel

- **Methods:** `list`, `create`
- **Webhooks:** none
- **List filters:** none
- **Readable fields:** `description`, `id`, `is_private`, `name`
- **Writable fields:** `description`, `is_private`, `name`
- **Vendor objects:** `room`
- **Model:** https://docs.unified.to/messaging/channel/model.md

### messaging_message

- **Methods:** `list`, `get`, `create`, `remove`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Required list filters:** `list_channel_id`
- **Readable fields:** `attachments`, `author_member`, `channels`, `created_at`, `id`, `message`, `message_html`, `message_thread_identifier`, `parent_id`
- **Writable fields:** none
- **Required on create:** `channels`, `message`
- **Vendor objects:** `event`
- **Model:** https://docs.unified.to/messaging/message/model.md

### passthrough

- **Methods:** none
- **Webhooks:** none
- **Readable fields:** none
- **Writable fields:** none