;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubTerra
Data Developer id and API keyRead wearable and health data — activity, sleep, body, nutrition — through Terra from any Windmill script, flow or app.
Set up in 3 steps
Copy your developer id and API key
In the Terra dashboard, both are on your developer account page.
Add the resource in Windmill
Open Resources, add a resource of type terra, and fill devId and apiKey.
Run your first script
Fork any script below and read before writing anything.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Retrieve workout plans for a given user ID
Retrieve user profile info for a given user ID
Retrieve sleep sessions for a given user ID
Retrieve nutrition log data for a given user ID
Retrieve menstruation data for a given user ID
Retrieve daily activity summaries for a given user ID
Retrieve body metrics for a given user ID
Retrieve activity data for a given user ID
Post workout plans to a provider
Post nutrition logs to a provider
Post body data to a provider
Post activity data to a provider
Modify user
Get list of available integrations
Get information for multiple user IDs
Get information for a single user ID or multiple users by reference ID
Get detailed list of integrations
Get all Terra User IDs
Generates an authentication token for the Terra mobile SDKs
Generate an authentication link, using the Terra Authentication Widget
Generate an authentication link
Delete workout plans for a given user ID
Delete nutrition logs for a given user ID
Delete body metrics for a given user ID
Deauthenticates a user and deletes any cached data for them
Resource type
terra — the shape of the credential every script on this page expects.
| Field | Type | Required | What it is |
|---|---|---|---|
| apiKey | string | Yes | API key from the dashboard |
| devId | string | Yes | Developer ID from the dashboard |
Questions
A user returns no data
Terra reads through connections your users authorised. If the user has not linked that wearable, or the link expired, there is nothing to read.
This is health data
It is. Keep the resource in a folder only the right people can read, and be deliberate about what a flow stores.
Are my credentials stored on the hub?
Never. They live only in your own Windmill workspace, encrypted at rest.