Release Notes

Keep up to date with recent changes to the APIs, SDKs, and documentation.

2025.03

• New SDK version 3.27.0 added.
• Google Health Connect is now supported in the Device Data APIs/SDKs. In particular, the SDK contains methods for prompting the participant to configure Health Connect from within the MyDataHelps Android app.
• REST API calls now perform stricter type validation, particularly around identifiers. If you are receiving 400 errors (Bad Request), check that your API calls are sending valid parameters.

2024.10

• New SDK version 3.24.0 added.
• The SDK now supports a queryDeviceDataV2DailySleep method to query aggregated sleep data.
• You can now get a list of all queryable device data types for Device Data API V2 namespaces via the API and SDK.
• Device data queries now support querying by properties and dataSource for device-specific metadata.
• Survey tasks now support querrying by survey category.
• The openExternalUrl and openEmbeddedUrl SDK navigation methods are now available in Web View steps.
• You can now manage your project’s saved Export Explorer queries through the Exports API.

2024.06

• The SDK now supports a persistParticipantInfo() method.
• The notification history now includes schedule and sender information in the API and SDK.
• Survey tasks and answers now include schedule information in the API and SDK.
• The projects API now includes an institutionsEnabled flag to show whether the project has allowed institutions.
• You can now promote a project to production and see its production status using the projects API.

2024.05

• New SDK version 3.15.0 added.
• New Device Data V2 API and SDK. See Device Data API Versions for important differences between V1 and V2.
• Added participant file uploads to the API and SDK.
• Expanded tutorials/examples for creating custom apps with MyDataHelps Embeddables.
• You can now get the survey context for Web View steps, to tweak behavior/appearance when testing.

2023.10

• New SDK version 3.8.0 added, including iOS 17 support.
• The MyDataHelps View Builder now makes it even easier to create a custom view.
• New properties, isMainSleep and logType now exist in the Fitbit sleep log in the REST API and SDK. These fields will only be populated in newly polled data.
• When querying the Participant API for a specific segment, the query now returns the date when each participant was added to the segment.
• The Survey API and SDK now return the survey category when querying tasks.

Deprecation Notice: Secondary Identifier

The participant secondaryIdentifier field is being deprecated as a first-class identifier within MyDataHelps. Any existing secondary identifiers will be migrated to a custom field named SecondaryIdentifier. For backwards compatibility, the API/SDK secondaryIdentifier will just be an alias for that custom field.

2023.08

• Learn more about how to use the MyDataHelpsUI React Component Library in custom views.
• New API operations have been added for External Accounts, Participant Segments and Project Institutions.
• Participant tokens now support scopes for limiting permissions.
• New SDK version 3.7.0 with some new methods to manage device data points.
• The SDK now supports an easier way of getting previous step answers in Web View steps.

2023.05

• New SDK version 3.6.0 added, including Apple Health and Fitbit methods.
• Garmin data is now supported in the device data API and SDKs.
• iOS SDK 2.0.0 released, adding project settings and survey presentation features; type-safe identifiers and Swift async syntax; minor changes to various other APIs; and reworked documentation, guides, and example app.

2023.02

• New Java quickstart app for the REST API.
• JavaScript SDK getParticipantInfoFields now returns a projectID.
• JavaScript SDK methods now specify whether they are supported in Embeddables in addition to Views.