1. Providers
  2. Test data

This feature is currently under development for the following providers:

  • Apple Health Kit
  • Fitbit
  • Oura
  • Whoop

The others will be coming soon. If there is a particular provider you would like us to add please do not hesitate to contact us at support@tryvital.io!

When integrating with Vital, you may not own a physical device for each provider you’re planning to support. For this, we provide demo users with test data so you can build and test the whole integration without touching a real device.

A demo user gives you the same experience as using a real one, the only difference is that you won’t go through the Vital Link flow.

Usage

First, you need a Vital user. You can create one either through the dashboard or through the API.

After creating the user, the Users page of your dashboard will look like this:

Now you can create a demo connection for the Vital user you just created, in this case 150db84c-537c-4cad-a6e9-24dc589d7fa2. You can directly hit the API endpoint or using one of our client libraries, as shown below:

curl --request POST \
     --url {{BASE_URL}}/v2/link/connect/demo \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-vital-api-key: <your_api_key>' \
     --data '{"user_id": "<user_id>", "provider": "<provider>"}'

After the demo connection is created, a Fitbit logo will appear beside your user.

From here, everything works exactly the same as if you connected a real device. This means you will receive the following webhook updates:

  • Connection created, as soon as the connection is created.
  • Historical webhooks. We simulate historical data for the demo device and send the corresponding webhook updates, as in the real-world scenario.
  • Daily webhooks. We also simulate updates to the device data every couple of hours so you can test receiving the data when a user recorded a workout or other activity.
  • Refresh user data. You can also instantaneously refresh a user’s data through this endpoint.