POST
/
v3
/
measurements
/
post

Authorizations

Authorization
string
headerrequired

Enter your bearer token in the format Bearer access_token_here

Body

application/json · object[]
startAt
string
default: 2022-01-01T00:00:00required

Start Time for the measurement event in UTC ISO 8601 like 2020-01-01T12:12:12

value
number
default: 3required

Measurement value

variableCategoryName
enum<string>
default: Emotionsrequired

Ex: Emotions, Treatments, Symptoms...

Available options:
Activity,
Books,
Causes of Illness,
Cognitive Performance,
Conditions,
Emotions,
Environment,
Foods,
Goals,
Locations,
Miscellaneous,
Movies and TV,
Music,
Nutrients,
Payments,
Physical Activities,
Physique,
Sleep,
Social Interactions,
Software,
Symptoms,
Treatments,
Vital Signs
variableName
string
default: Overall Moodrequired

Name of the variable for which we are creating the measurement records

unitAbbreviatedName
string
default: /5required

Unit of measurement

combinationOperation
enum<string>
default: Meanrequired

Way to aggregate measurements over time. SUM should be used for things like minutes of exercise. If you use MEAN for exercise, then a person might exercise more minutes in one day but add separate measurements that were smaller. So when we are doing correlational analysis, we would think that the person exercised less that day even though they exercised more. Conversely, we must use MEAN for things such as ratings which cannot be SUMMED.

Available options:
MEAN,
SUM
sourceName
string

Name of the application or device used to record the measurement values

upc
string

UPC or other barcode scan result if you want to attach it to the variable name for recording measurements with a UPC scanner

note
string

Optional note to include with the measurement

Response

201 - application/json
status
string
required

ex. OK or ERROR

success
boolean
required

true or false

data
object
message
string

Message

description
string

Can be used as body of help info popup

summary
string

Can be used as title in help info popup

errors
object[]

Array of error objects with message property

code
number

Response code such as 200

card
object