Write Heart Rate via HTTP

Submit a heart rate reading for the authenticated user.

Request

name	value
url	https://dev.pulsoid.net/api/v1/data
method	POST
content-type	application/json
scope	data:heart_rate:write

Authentication

Provide your OAuth2 Bearer token using one of the following methods:

Method	Example
Query parameter	?access_token=YOUR_TOKEN
Header	Authorization: Bearer YOUR_TOKEN

Request Body

{
  "measured_at": 1709312400000,
  "data": {
    "heart_rate": 75
  }
}

Field	Type	Required	Description
measured_at	number	Yes	Unix timestamp in milliseconds when the heart rate was measured
data.heart_rate	integer	Yes	Heart rate in beats per minute. Must be greater than 0

Heart rate values of 0 or below are silently ignored and will not be stored.

HTTP Status Codes

Status	Description
200	Heart rate data accepted
400	Malformed request body
401	Missing or invalid token, or token does not have data:heart_rate:write scope
500	Unexpected server error (error code 6001)

cURL Request Example

curl -X POST https://dev.pulsoid.net/api/v1/data \
  -H "Authorization: Bearer 8c4da3ce-7ed7-4a19-a1f1-058498661e45" \
  -H "Content-Type: application/json" \
  -d '{"measured_at": 1709312400000, "data": {"heart_rate": 75}}'