Submit a filled custom questionnaire for a patient
Creates a submitted patient-questionnaire for an existing patient. The patient must belong to the clinic that owns the API key.
Use this endpoint for custom questionnaires you define yourself (intake forms, post-visit follow-ups, screeners, etc.). For mdhub-managed standardized questionnaires (PHQ-9, GAD-7, MADRS) use /questionnaires/submit-mdhub instead — it only needs raw integer scores and handles response-label mapping for you.
Each schema item is validated against its type. Supported types: input_title, input_free_text, input_number, input_single, input_multiple, input_list, input_likert, dropdown_single, dropdown_multiple. id and order on each schema item are always assigned by the server (id via UUID, order via array position starting at 1) — any values sent by the client are ignored. description defaults to "" and required defaults to false when omitted.
Once stored, an AI summary is generated automatically.
Request body
Example request
{
"patientId": "abc123",
"questionnaire": {
"title": "New Patient Intake",
"description": "Completed before the first visit.",
"questionnaireId": "intake_v1",
"schema": [
{
"title": "Current symptoms",
"scale": {
"label": "4-point scale frequency",
"value": "4_point_scale_frequency",
"items": [
"Not at all",
"Several days",
"More than half the days",
"Nearly every day"
]
},
"response": [
{
"col": "Medication",
"column": "Medication",
"responses": [
"Sertraline",
"Bupropion"
]
}
]
}
]
}
}Response
Questionnaire submitted successfully
Example response
{
"patientQuestionnaireId": "pq_123abc"
}Changes
No recorded changes to this endpoint across all 1 revision of this API.