✨ Improvements

We migrated the Airly feed to the new webhook system. Besides existing measurement system changes, the payload looks the same as before:

{
  "id": "00000000-0000-0000-0000-0000000000",
  "type": "airthings-webhook-cloudevent-airly-sample-feed",
  "source": "https://dashboard.airthings.com/integrations/webhooks/00000000-0000-0000-0000-0000000000?version=v2",
  "dataContentType": "application/json",
  "labels": {},
  "data": [
    {
      "serialNumber": "ARL0000000",
      "recorded": "2023-11-30T10:00:00Z",
      "outdoorHumidity": 73,
      "outdoorPm10": 28,
      "outdoorPm1": 13,
      "outdoorPm25": 22,
      "outdoorPressure": 1002.8,
      "outdoorTemp": -2.5,
      "ratings": {
        "outdoorPm25": "FAIR",
        "outdoorPm1": "FAIR",
        "outdoorPm10": "FAIR",
        "outdoorPressure": "GOOD"
      },
      "sensorUnits": {
        "outdoorPm25": "mgpc",
        "outdoorPm1": "mgpc",
        "outdoorPm10": "mgpc",
        "outdoorHumidity": "pct",
        "outdoorTemp": "c",
        "outdoorPressure": "hpa"
      }
    }
  ],
  "time": "2023-11-30T10:00:00.0Z",
  "specVersion": "0.2"
}

🐛 Fixes

  • Airly sample feed now respects unit preferences in the webhook settings.

📝 Documentation

We have updated the documentation of Webhook Event Types with the latest payload
change (see above) regarding mold feed.

🚀 Feature release

We added "ventilation rate" samples to the latest-samples endpoints:

... and new endpoints for historical samples:

Now, there are two new properties in the response:

  • airflow - cubic meters per hour (m³/h)
  • airExchangeRate - air changes per hour (ACH)

The availability of the virtual sensors will depend on your device type, and if the feature is enabled for the device in
the Dashboard. airflow is only available for devices where room size information has been entered.

✨ Improvements

We migrated the mold feed to the new webhook system. Besides existing measurement system changes, the payload looks the same as before:

{
  "id": "00000000-0000-0000-0000-0000000000",
  "type": "airthings-webhook-cloudevent-mold-sample-feed",
  "source": "https://dashboard.airthings.com/integrations/webhooks/00000000-0000-0000-0000-0000000000?version=v2",
  "dataContentType": "application/json",
  "labels": {},
  "data": [
    {
      "serialNumber": "0000000000",
      "recorded": "2023-10-02T20:00:00Z",
      "mold": 1,
      "ratings": {
        "mold": "GOOD"
      },
      "sensorUnits": {
        "mold": "riskIndex"
      }
    }
  ],
  "time": "2023-10-02T20:00:00.0Z",
  "specVersion": "0.2"
}

📝 Documentation

We have updated the documentation of Webhook Event Types with the latest payload change (see above) regarding mold feed.

✨ Improvements

Lux is now available in the payload. The devices that have light sensor and collect this are currently Space CO2 Mini and Space Nano.

✨ Improvements

We have improved the fields below:

  • pressure is now converted from Pascal to HectoPascal.
  • light is now presented in percentages.

✨ Improvements

As we are moving away from using measurement system (Metric or Imperial) to define sensor units in Webhooks,
and making it possible to select units per sensor instead, we're making some updates to the API

In summary:

  • measurementSystem is removed from the response to requests about webhooks
  • sensorUnits is mandatory when adding a webhook

Changes to the webhook system is documented in the Webhook changelog.

✨ Improvements

As we are moving away from using measurement system (Metric or Imperial) to define sensor units, and making it possible to select units per sensor instead, we're making some updates to Webhooks.

sensorUnits was introduced on 2021-12-06 to eventually replace measurementSystem, so measurementSystem will now be removed from webhook payloads coming from the new system.

Changes to the API is documented in the API changelog.

✨ Improvement

  • Virus risk have now been completely migrated to the new webhook system. User will no longer receive data from the old webhook system.

📝 Documentation

  • We have update the documentation of Webhook Event Types with the latest changes regarding virus risk.
  • We have update the documentation of Webhook FAQ to answer how you can distinguish between payload coming from the old and new system.

🚀 Feature Release

Occupancy is now available publicly to all webhook users.

Occupancy can be enabled in webhook by adding occupancy-sample-feed when create/modify a webhook in the dashboard or the API

Below is an example payload of the occupancy sample feed.
Note that null values will not be encoded into the payload:

{
  "id": "d7254d54-0d83-4b86-a927-895231426a67",
  "type": "airthings-webhook-cloudevent-occupancy-sample-feed",
  "source": "https://dashboard.airthings.com/integrations/webhooks/9a7c4f92-340a-4414-8175-2d09966931cc?version=v2",
  "dataContentType": "application/json",
  "labels": {},
  "data": [
    {
      "serialNumber": "2930000000",
      "measurementSystem": "METRIC",
      "recorded": "2023-06-28T12:25",
      "occupantsUpper": 0, // can be null
      "occupants": 0,
      "occupantsLower": 0, // can be null
      "sensorUnits": {
        "occupants": "occ"
      }
    }
  ],
  "time": "2023-06-28T12:30:08.463483",
  "specVersion": "0.2"
}