All data is sent to your webhook in JSON format in the form of 5 different types of payloads:
Sleep; depending on your needs, you may select a subset of
the aforementioned, and request less data from your users.
Examples of data payloads can be found here. If you would only like to receive specific fields out of the ones available, you may also select only the ones relevant to your needs and omit the rest. The following is an example of the data payload you may expect from an activity coming from Terra.
Our infrastructure revolves around webhooks. When setting up your Terra account, you will be prompted to provide a callback URL, to which Terra may send PUSH data using POST requests.
Your Oura integration with Terra supports delivery of data without needing to periodically request it yourself. We query Oura for new data every 20 minutes, and POST normalized data to your webhook whenever data is available.
You may also use HTTP requests with your Oura integration in case you wish to request historical data or data over extended periods of time.
Most HTTP endpoints can take additional
which allow you to request for data over a specific period for the given user.
In order to use the widget integration, simply open a WebView within your app pointing to
as query parameters.
Additional configuration parameters can be
passed into the widget for customization options.
Any user following through with authentication using the above will be linked back to your Terra account.