Oura
Connect to Oura to read sleep, activity, readiness, heart rate, and workout data from your Oura Ring.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
Oura
OAuth sign-in
Oura
Connect to Oura to read sleep, activity, readiness, heart rate, and workout data from your Oura Ring.
Set up in Oura
Use a Oura account with access to the records and operations that your workflow needs.
If your organization restricts application access or user consent, have its administrator approve the connection before you sign in.
Set up in StackAI
Open Settings → Connections, add a connection, and select Oura.
Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required Oura action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Get Daily Sleep Summary
Pull your daily sleep summaries over a date range. Each day includes the sleep score and its contributors (deep sleep, efficiency, latency, REM sleep, restfulness, timing, and total sleep).
Required permissions: daily.
Inputs
Start date
date
No
Only include days on or after this date. Leave empty to use Oura's default window.
End date
date
No
Only include days up to this date. Leave empty to include today.
Target results
integer
No
How many daily summaries to fetch before stopping. The final Oura page may make the result larger. Minimum: 1. Default: 31.
Page cursor
string
No
Continue from where a previous run left off. Paste the token from the last run to fetch the next page.
Outputs
Daily sleep summaries
object_array
The list of daily sleep summaries in the window.
Next page cursor
string
Token to fetch the next page of summaries, if any remain.
Get Daily Activity Summary
Pull your daily activity summaries over a date range. Each day includes the activity score, steps, calories, activity time breakdowns, and the score contributors.
Required permissions: daily.
Inputs
Start date
date
No
Only include days on or after this date. Leave empty to use Oura's default window.
End date
date
No
Only include days up to this date. Leave empty to include today.
Target results
integer
No
How many daily summaries to fetch before stopping. The final Oura page may make the result larger. Minimum: 1. Default: 31.
Page cursor
string
No
Continue from where a previous run left off. Paste the token from the last run to fetch the next page.
Outputs
Daily activity summaries
object_array
The list of daily activity summaries in the window.
Next page cursor
string
Token to fetch the next page of summaries, if any remain.
Get Daily Readiness Score
Pull your daily readiness scores over a date range. Each day includes the readiness score, skin temperature deviations, and the score contributors (HRV balance, resting heart rate, sleep balance, and more).
Required permissions: daily.
Inputs
Start date
date
No
Only include days on or after this date. Leave empty to use Oura's default window.
End date
date
No
Only include days up to this date. Leave empty to include today.
Target results
integer
No
How many daily summaries to fetch before stopping. The final Oura page may make the result larger. Minimum: 1. Default: 31.
Page cursor
string
No
Continue from where a previous run left off. Paste the token from the last run to fetch the next page.
Outputs
Daily readiness summaries
object_array
The list of daily readiness summaries in the window.
Next page cursor
string
Token to fetch the next page of summaries, if any remain.
List Heart Rate Data
Pull your heart rate samples over a time window. Each sample includes the beats per minute and the context it was recorded in (rest, sleep, workout, and more). Samples are recorded roughly every five minutes.
Required permissions: heartrate.
Inputs
Start time
datetime
No
Only include samples on or after this time. Leave empty to use Oura's default window.
End time
datetime
No
Only include samples up to this time. Leave empty to include everything up to now.
Target results
integer
No
How many heart rate samples to fetch before stopping. The final Oura page may make the result larger. Minimum: 1. Default: 288.
Page cursor
string
No
Continue from where a previous run left off. Paste the token from the last run to fetch the next page.
Outputs
Heart rate samples
object_array
The list of heart rate samples in the window.
Next page cursor
string
Token to fetch the next page of samples, if any remain.
List Workouts
Pull your workouts over a date range. Each workout includes the activity type, calories, distance, start and end times, intensity, and whether it was auto-detected or entered manually.
Required permissions: workout.
Inputs
Start date
date
No
Only include workouts on or after this date. Leave empty to use Oura's default window.
End date
date
No
Only include workouts up to this date. Leave empty to include today.
Target results
integer
No
How many workouts to fetch before stopping. The final Oura page may make the result larger. Minimum: 1. Default: 31.
Page cursor
string
No
Continue from where a previous run left off. Paste the token from the last run to fetch the next page.
Outputs
Workouts
object_array
The list of workouts in the window.
Next page cursor
string
Token to fetch the next page of workouts, if any remain.
Important behavior
If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?

