Skip to main content

Oura Notifications Export Format

  • Updated

The Oura Notification Export details webhook notifications sent to users when data is created, updated, or deleted. 

  • File Prefix: `OuraNotifications`

For a complete list of all the export file types possible, see the Oura Export Overview.

Data Fields

Field Description
NotificationsKey The unique key for this notifications record, formatted as `ParticipantID_ObjectID_EventTime`.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
ParticipantIdentifier The identifier of the participant this notification is for. Can be used to cross reference with Participants.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.
EventType The event type of the webhook notification, either `"create"`,`"update"`, or `"delete"`.
DataType

The data type of the webhook notification. Possible values are:

  • `"tag"`
  • `"enhanced_tag"`
  • `"workout"`
  • `"session"`
  • `"sleep"`
  • `"daily_sleep"`
  • `"daily_readiness"`
  • `"daily_activity"`
  • `"daily_spo2"`
  • `"sleep_time"`
  • `"rest_mode_period"`
  • `"ring_configuration"`
  • `"daily_stress"`
  • `"daily_cardiovascular_age"`
  • `"daily_resilience"`
  • `"vo2_max"`
ObjectID The Object ID of the webhook notification subscription.
EventTime Event time of the webhook notification.
UserID The User ID of the user who received the webhook notification.

Sample CSV Export

NotificationsKey,ParticipantID,ParticipantIdentifier,InsertedDate,EventType,DataType,ObjectID,EventTime,UserID
6e2626f8-e891-ed11-98ad-f4ce23710c45_b5c38a54-d0d0-4b68-a18f-bd97171d82de_2025-03-13T19:11:43.975-04:00,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:12Z,update,daily_stress,b5c38a54-d0d0-4b68-a18f-bd97171d82de,2025-03-13T19:11:43.975-04:00,-d3a1922-6e05405-c72bede995a6ff4eda3
6e2626f8-e891-ed11-98ad-f4ce23710c45_b5c38a54-d0d0-4b68-a18f-bd97171d82de_2025-03-13T18:41:34.745-04:00,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:11Z,update,daily_stress,b5c38a54-d0d0-4b68-a18f-bd97171d82de,2025-03-13T18:41:34.745-04:00,-d3a1922-6e05405-c72bede995a6ff4eda3
6e2626f8-e891-ed11-98ad-f4ce23710c45_6d1a196e-21cf-43ca-88e9-73fc3211da48_2025-03-13T19:11:42.925-04:00,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:11Z,update,daily_activity,6d1a196e-21cf-43ca-88e9-73fc3211da48,2025-03-13T19:11:42.925-04:00,-d3a1922-6e05405-c72bede995a6ff4eda3

Sample JSON Export

{
    "NotificationKey": "6e2626f8-e891-ed11-98ad-f4ce23710c45_6d1a196e-21cf-43ca-88e9-73fc3211da48_2025-03-13T19:41:52.81-04:00",
    "ParticipantID": "6e2626f8-e891-ed11-98ad-f4ce23710c45",
    "ParticipantIdentifier": "46ce54ac-e891-ed11-98ad-f4ce23710c45",
    "InsertedDate": "2025-03-13T23:42:02Z",
    "EventType": "update",
    "DataType": "daily_activity",
    "ObjectID": "6d1a196e-21cf-43ca-88e9-73fc3211da48",
    "EventTime": "2025-03-13T19:41:52.81-04:00",
    "UserID": "-d3a1922-6e05405-c72bede995a6ff4eda3"
}

Was this article helpful?