Book a demo

List Heart Rate

oura.list_heartrate
ActionBusiness appsconnection required

Calls the Oura API with the connection's credentials.

Read the heart-rate time series. This collection windows on date-times rather than dates, and can return just the most recent sample.

Ask about OuraAll Oura nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Oura
Secret shape
the Oura access token, or {"access_token": "…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
start_datetime
Earliest sample to return, as an ISO-8601 date-time. Leave empty for Oura's default window.
stringNo—iso8601 format2026-09-10T00:00:00+00:00
end_datetime
Latest sample to return, as an ISO-8601 date-time. Leave empty for Oura's default window.
stringNo—iso8601 format2026-09-10T23:59:59+00:00
next_token
Cursor from a previous call's next_token, to fetch the following page.
stringNo———
latest
Return only the most recent heart-rate sample.
booleanNofalse——

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "end_datetime": "2026-09-10T23:59:59+00:00",
  "latest": false,
  "start_datetime": "2026-09-10T00:00:00+00:00"
}

Output

One shape.

result

FieldTypeExample
data[].bpm
Heart rate for the sample, in beats per minute.
number—
data[].source
Which measurement produced the sample, e.g. awake or rest.
string—
data[].timestamp
UTC timestamp of the sample.
string—
data[].timestamp_unix
The same timestamp as unix time in milliseconds.
number—
count
How many documents this page carried.
number—
next_token
Cursor for the next page; empty on the last page.
string—
{
  "count": 0,
  "data": [
    {
      "bpm": 0,
      "source": "",
      "timestamp": "",
      "timestamp_unix": 0
    }
  ],
  "next_token": ""
}

Related Oura nodes

See List Heart Rate run in a workflow.

In a technical demo we add the Oura connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales