Tenovi API Release Notes
2024-10-7
IMPROVEMENTS
- For clients with ASR plans, you can now track glucometer strip quantities and request replacement strips for Tenovi Cellular Glucometers. See our updated ASR documentation for more details. Specifically, you must use the IMEI of the related Tenovi Cellular Glucometer when retrieving/updating glucometer supply information or creating a new supply request. For gateway-connected glucometers, you can continue to use the corresponding Gateway ID.
2024-9-26
New Features
- A new “ship_gateway_only” flag has been added to the Fulfillment Request object when adding a new Device via the hwi-devices endpoint. This flag should be used in situations where a patient already owns a Tenovi Gateway-compatible device (e.g. a BPM), but you still need Tenovi to dropship a Gateway to the patient. For these requests, you will only be billed for the Gateway.
2024-8-2
IMPROVEMENTS
- Measurement Webhooks now have an “enabled_by_default” flag that, if set to False, allows Webhooks to be added to your account without having measurement data for all devices sent to that Webhook by default. The measurement_webhook_id clientDeviceProperty (see here) can then be used to enable a measurement webhook for a specific device, even if that Webhook is not enabled by default. This can be used to, for example, selectively test a new measurement webhook with a small number of devices before enabling it for all devices. The default value for this flag is “True.”
2024-7-15
IMPROVEMENTS
- Browser-based calls to the Tenovi API are now restricted to trusted hosts only.
2024-5-21
IMPROVEMENTS
- For HWI Clients that use Fulfillment Webhooks, “Replaced” and “Unlinked” webhooks now include the hardware_uuid for the prior device (e.g. the Gateway being replaced or unlinked) in the previously deprecated “device_id” field. As a reminder, the current hardware_uuid (e.g. for the Gateway that was sent as a replacement, or null if unlinked) is provided in the “hardware_uuid” field.
2024-5-7
New Features
- HWI clients can now configure HWI devices to send measurement data to a single, user-selected Measurement Webhook (by default, measurement data is sent to all Webhooks). To select a single Webhook for a device, simply use the HWI Device Properties endpoint to create a new property with the parameters listed below.
- key: “measurement_webhook_id”
- value: the id of the desired webhook, which can be retrieved using the HWI Webhooks endpoint, or on the Edit Webhook popup on the Tenovi WebApp. Set to a blank string to revert the device to the default behavior.
- HWI clients can also lookup all devices associated with a specific Webhook using the properties__key and properties__value query parameters on the HWI Devices endpoint (set the key parameter to “measurement_webhook_id” and the value parameter to the id of the Webhook you want to filter by).
2024-4-17
New Features
- For HWI Clients, we added a new hwi-gateways endpoint that returns a paginated list of all Gateways associated with your account with useful dates for sorting. See the updated documentation for more details.
- For HWI Clients, we updated the hwi-gateway-info endpoint to include explicit fields that indicate when a Gateway was assigned to your account, when it was dropshipped (if applicable), and what devices (if any) are whitelisted to the Gateway.
2024-4-11
IMPROVEMENTS
- For HWI clients, when activating/requesting a new HWI Device with additional patient information, the patient.external_id field is now optional and you can now include a patient email address. This email is not validated and is for reference only; the Tenovi Tech Support team may also use it for resolving service requests.
2024-1-11
New Features
- For ASR clients, we added a new asr-supply-types endpoint that you can use to fetch a list of valid supply names that you can use to order supplies via API.
2023-10-11
New Features
- Glucometer Supplies Endpoint: We added a new endpoint for clients with our Automated Supply Replenishment (ASR) plan enabled that allows API users to query our system for an estimated number of glucometer strips remaining for a given patient (based on the number of strips we have shipped minus the number of measurements taken) or to update this estimate manually (for example, if extra strips were provided directly by the client). See https://api2.tenovi.com/
supply-redoc for more details.
Improvements
- We refactored our “Request Supply” endpoint for clients with ASR plans to be grouped with all other ASR-specific endpoints. The original endpoint will be temporarily maintained to preserve backwards compatibility, but clients are encouraged to migrate to the new endpoint in a timely manner.
- Original endpoint: CLIENT_DOMAIN/devices/supply-
requests/ - New endpoint: CLIENT_DOMAIN/asr/supply-
requests/
- Original endpoint: CLIENT_DOMAIN/devices/supply-
2023-09-18
New Features
- Array-based Webhook POST: Measurement Webhooks can now be configured to POST related measurements (e.g. blood_pressure and pulse captured from a single BPM reading) as a single JSON array instead of individual requests.
- Simplified Signature Confirmation Requests: For devices that will be dropshipped by Tenovi, API users can now request signature confirmation of delivery using a boolean field in the FulfillmentRequest object instead of a separate Device Name (additional charges may apply).
Improvements
- Standardized all timestamps present in Webhook data to be formatted as “YYYY-MM-DDTHH:MM:SS.ssssssZ” (e.g., 2023-09-13T07:53:21.000000Z). Please double-check your Webhook integrations to make sure the timestamp formatting changes will not affect your data processing.
- Simplified the “hwi-devices” endpoint by removing the requirement to include a matching “sensor_code” for a given device. Now, only the “device.name” field is required.
- Added a “webhook_responses” field to the Measurements object that records all the HTTP response codes for any webhooks that fired for that specific measurement (comma-separated).
- Enabled HWI Webhooks for all measurements, even those captured from devices associated with our RPM-software based accounts.
- Add “image”, “up_front_cost”, and “shipping_cost” fields to the hwi-device-types endpoint to improve custom shop integrations.
Get Notified of Changes
Sign up to get email notifications of any Tenovi API changes.