Set up an MQTT Publisher configuration to have Airthings push sensor data and hub metadata directly to your MQTT broker.

Step 1: Prerequisites

• An Airthings organization with devices provisioned
• An MQTT broker accessible from the internet (e.g., AWS IoT Core, Active MQ)
• Broker hostname, port, and credentials ready

Step 2: Create an MQTT configuration

Create a configuration by navigating to create-mqtt-publisher.

All buildings are selected by default or select buildings.

Choose the required protocol for the broker

Upload the relevant credentials

Use the defaults topic format or enter your custom topic format for the broker.

Select preferred units and click "Create".

Step 3: Test the connection

Once the config is created, verify broker connectivity by clicking Test Connection button.

A test message is published to a topic generated from your template using test values (serialNumber: 0000000000, locationId: test, messageType: sample).

{
  "status": "CONNECTION_AND_PUBLISH_SUCCESS",
  "message": "Successfully connected and published test message to topic: org-123/test/0000000000/sample"
}

Possible status values:

Step 4: Verify data flow

1. Subscribe to your broker's topic matching your template pattern (e.g., {accountId}/#)
2. Wait for real device data to arrive (devices typically report every 5 minutes)
3. Validate the JSON payload structure — see Topics for the full payload reference

Validation rules