Oura · Schema
Oura Webhook Subscription
A webhook subscription registered via /v2/webhook/subscription. Posts events to callback_url on create / update / delete for a specific data_type.
ActivityBiometricsCardiovascularFitnessHealthHRVQuantified SelfReadinessResilienceRingSleepSpO2StressWearablesWellnessWomen's Health
Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| callback_url | string | Developer-controlled HTTPS endpoint that receives event notifications. |
| verification_token | string | Secret used by Oura when verifying the subscription handshake. |
| event_type | string | |
| data_type | string | |
| expiration_time | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://api-evangelist.github.io/oura-ring/json-schema/oura-webhook-subscription-schema.json",
"title": "Oura Webhook Subscription",
"description": "A webhook subscription registered via /v2/webhook/subscription. Posts events to callback_url on create / update / delete for a specific data_type.",
"type": "object",
"required": ["callback_url", "verification_token", "event_type", "data_type"],
"properties": {
"id": { "type": "string" },
"callback_url": {
"type": "string",
"format": "uri",
"description": "Developer-controlled HTTPS endpoint that receives event notifications."
},
"verification_token": {
"type": "string",
"description": "Secret used by Oura when verifying the subscription handshake."
},
"event_type": {
"type": "string",
"enum": ["create", "update", "delete"]
},
"data_type": {
"type": "string",
"enum": [
"tag",
"enhanced_tag",
"workout",
"session",
"sleep",
"daily_sleep",
"daily_readiness",
"daily_activity",
"daily_spo2",
"sleep_time",
"rest_mode_period",
"ring_configuration",
"daily_stress",
"daily_resilience",
"daily_cardiovascular_age",
"vO2_max",
"heartrate"
]
},
"expiration_time": {
"type": "string",
"format": "date-time"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/oura-webhook-subscription"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.