integrating with diet id
Diet ID provides digital nutrition tools to assess and track current nutritional intake, develop custom nutrition plans based on health goals, and guide individuals to their goals through personalized digital daily coaching. As a partner, you can use our stand-alone web-based tools with your population. If you use another digital platform to manage your population and want to embed Diet ID’s modules there, Diet ID can support integration to help you build a seamless experience.
Diet ID is currently integrated with the following platforms:
Epic (via App Orchard)
Cerbo
Wellavate by Emerson Ecologics
Meliora Technology
Album Health
The basics
There are a few ways to integrate Diet ID into your experience. They generally address two concerns: how the user interacts with Diet ID’s modules and how you retrieve the results of those interactions.
User Interactions
To give your population access to the Diet ID tools, e.g. have your population take the digital diet assessment, you can point the user to a white-labeled version of Diet ID or you can embed Diet ID within your website or app.
Direct URL
The simplest way to add Diet ID is to distribute the url for your custom, white-labeled product (e.g., https://yourtoken.dietid.com or a custom domain) via your website, app, email, or other means. The experience is fully branded with your name, logo, and colors. When users visit the site they will create an account and complete the modules you choose for your deployment.
This method is perfect for you if you don’t have a digital platform to manage your population and/or you don’t have the technical resources to integrate Diet ID’s modules but still want to offer it to your population.
Setup for this usually takes less than a day.
Embedded
If you have an app or a website and you want Diet ID’s modules accessible there, you can embed Diet ID’s modules with a simple iframe. To do this simply add an iframe tag with the src attribute set to your custom url.
If you’d like to hide certain elements of the Diet ID modules in your iframe, you can add parameters to the URL:
To hide the sidebar with branding a custom welcome message, add ?view=nosidebar to the URL
To hide the progress bar, add ?view=noprogressbar to the url
To hide both the sidebar and progress bar, add ?view=nosidebar,noprogressbar to the url
For a full list of view parameters, please contact your account manager
Users will still need to create accounts or sign in to use the tools, but the experience will take place within your app or digital platform, and therefore appear more seamless.
This method is perfect if you have a website or landing page where you drive all of your users, and you want Diet ID’s modules to “live” there, but you have limited tech resources.
Set up for this usually takes one day.
Embedded with SSO (Single-sign on)
If your app or digital platform has an account creation process for users (e.g. a patient portal) and you want your users to use Diet ID’s modules after they have signed into your platform, you can use our Single-Sign-On (SSO) solution. Your users can use Diet ID without having to create new or separate accounts; we can automatically create accounts for them via SSO. This process ensures a one-to-one mapping between your user accounts and corresponding Diet ID accounts. Implementing our SSO solution will require that you generate SSO urls using a secret key shared between your backend and Diet ID's backend.
New Diet ID users who haven't completed an assessment will see the assessment, while users who have completed one of the Diet ID modules will see their dashboard. Accounts are automatically deduped based on the user id you pass to Diet ID.
This method is perfect if you use a digital platform where your population already signs in — e.g. a patient portal or a mobile app.
Set up for the Single Sign On integration can be done in as little as a couple days depending on your technical team’s availability. In addition to your custom Diet ID URL, you will also need the partner secret key. Diet ID will provide this directly to you once your implementation needs are finalized.
Retrieving Results
To retrieve results in real time, data can be manually accessed by you, pushed to you via webhooks, or pulled by you via our API. Depending on your relationship with your users, you may have different types of access to data. For example, if you are a HIPAA compliant health care provider, you are eligible to access our full data set.
Use our admin portal (no technical integration required)
If you want to manually access you users’ diet assessment data and goal setting results, and you are a HIPAA compliant partner, we can give you access to an admin portal where you’ll receive user results in real time. Data can also be exported in CSV and JSON directly from that reporting tool. Using this admin portal does not require any additional technical integration. Here is a list of data the admin portal provides.
This is the simplest and fastest way to access your population’s data. Even if you have your own patient or client management system like an EHR, many of our partners choose this solution because you can get up and running in as little as 1 day.
Webhook (some integration required)
If you want to automatically receive a user’s data such that it is appended to your own patient or client management system, we can set up a webhook with your system. Whenever a user completes a Diet ID assessment, their results will be POST'ed to the configured URL you share with us. If users are created via SSO, the data we share via the webhook will include the user id you passed to us for easy mapping with existing users.
To set up a webhook, we will simply need the URL where you want us to POST the data in real time. Set up takes less than a day.
API
You can use our API to pull individual data about a participants assessment history, nutrient intake, food group intake, and challenge participation. Integrating with our API will allow you to embed Diet ID data throughout your experience and use it to power additional points of engagement — e.g. incentivize challenge participation, embed Diet ID’s score into a larger scoring system, build a unified patient or provider dashboard, etc.
READY TO GET STARTED?
Please reach out to our team to schedule a demo and learn about how our integration options can support your needs.
