Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Connector
Authentication

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

  1. Use a Oura account with access to the records and operations that your workflow needs.

  2. If your organization restricts application access or user consent, have its administrator approve the connection before you sign in.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Oura.

  2. Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.

  3. 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

  1. Add the required Oura action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. 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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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?