RootBridge App

Export your community's data to external services through scheduled webhook deliveries.

note

Apps and Bots are only available on Desktop.

What is RootBridge?

RootBridge is a data export app that sends snapshots of your community's information to external services via webhooks. You choose which data to include (channels, roles, member counts, and more), point it at a URL, and RootBridge delivers a JSON payload on a regular schedule. This lets you feed community data into dashboards, bots, analytics tools, or any service that accepts HTTP webhooks.

How it works

A bridge is a configured webhook export. Each bridge defines a target URL, which community data fields to include, and optional custom fields. RootBridge delivers the selected data as a JSON payload to the target URL on a fixed schedule.

Data fields

When creating a bridge, you select which community data to include in each delivery. Fields are grouped into categories:

Category	Fields
Community Info	Community Name, Community Icon
Member Statistics	Member Count
Structure	Channels, Channel Groups, Roles
Voice	Voice Channels

Only selected fields appear in the delivered payload. You can change your selection at any time by editing the bridge.

Custom fields

Each bridge can include custom fields: key-value pairs that are added to every delivery. Use these to tag payloads with identifiers, environment names, or any metadata your receiving service needs.

Delivery schedule

Bridges deliver data every 15 minutes. RootBridge checks for due deliveries every 60 seconds, builds a snapshot of the selected community data, and sends it as an HTTP POST request to the target URL. Each delivery includes a JSON payload with the following structure:

• Metadata: community ID, export ID, export name, and a timestamp
• Data: the selected community data fields (channels, roles, etc.)
• Custom: your custom key-value fields

Statuses

Each bridge has a status that reflects its current state:

Status	Meaning
Active	Delivering on schedule.
Error	The last delivery failed. RootBridge continues to retry on schedule and returns to Active when a delivery succeeds.

Delivery logs

Every delivery attempt is recorded in a log. Each log entry shows whether the delivery succeeded, the HTTP status code returned, how long the request took, and the payload size. Use delivery logs to diagnose issues with your receiving service.

Roles and permissions

RootBridge uses a single permission group configured by community leaders.

Role	Description
Bridge Admins	Users and roles who can create and manage webhook data exports.

What Bridge Admins can do

• Create, edit, and delete bridges
• Select data fields and custom fields
• Test deliveries on demand
• View delivery logs

Members without the Bridge Admin permission cannot see or interact with RootBridge.

Create a bridge

Bridge Admins can create new webhook exports.

1. Select New Bridge (or the create button if no bridges exist yet).
2. Enter a Name for the bridge.
3. Enter the Webhook URL where payloads should be delivered.
4. Select at least one data field to include in deliveries.
5. Optionally add custom fields (key-value pairs).
6. Select Create.

The bridge starts in Active status and delivers its first payload within 15 minutes.

Create bridge fields

Field	Required	Limit	Notes
Name	Yes	100 characters	A descriptive label for this bridge
Webhook URL	Yes	None	The HTTP endpoint that receives payloads
Data Fields	Yes (at least 1)	7 available	Select which community data to include
Custom Fields	No	None	Key-value pairs added to every delivery

Test a bridge

Bridge Admins can trigger an immediate test delivery to verify the webhook URL and payload.

1. Open an existing bridge.
2. Select Test.

RootBridge sends a delivery immediately using the bridge's current settings. The result appears in the delivery logs.

Edit a bridge

Bridge Admins can update any bridge's settings.

1. Open the bridge you want to edit.
2. Update the Name, Webhook URL, data fields, or custom fields.
3. Select Save.

Changes take effect on the next scheduled delivery.

Delete a bridge

Bridge Admins can permanently remove a bridge.

1. Open the bridge you want to delete.
2. Select Delete.
3. Confirm the deletion.

Deleting a bridge stops all future deliveries and removes its delivery logs. This action cannot be undone.