Create Submission

This endpoint is used for creating a submission for your form(s). During onboarding, your administrator will have been informed about field names. Your submission data must match these names. An example has been provided down below.

Create a new submission

POST https://api.formdr.com/api/v1/practice/{practiceId}

Query Parameters

{
    "submissionId": number,
    "formId": number,
    "formName": "Name of the Form",
    "name": param.firstName + " " + param.lastName //concatentation of the sent parameters of firstName and lastName
    "formUuid": string,
    "submissionToken": string,
    "submissionUrl": string, //publicly accessible URL for patient
}

firstName and lastName parameters are used for patient records and will be the same when you're searching for records. Warning: these differ from firstName and lastName in the submissionData.

The submissionData is a JSON string that maps to each field in the form. During form creation, each field is generated with a unique ID. This ID can be changed to best suit your purposes. Some fields, like the Single-Select Option field, can be given specific values.

You will notice below there is a takingMedicineCheckbox which returns a boolean value, but a painYesNo variable that is a string of 'true'. This is because the field is a Single-Select Option field. The default value of which is 'true', but it can be any value that the form creator wants.

This endpoint does not enforce key names. Any typos or extra keys will result in the insertion of this data and may cause display errors or data to not be displayed if it wasn't configured in the form.

submissionData example

{
"takingMedicineCheckbox": true,
"signedDate": "11/07/2022",
"firstName": "Aaron",
"lastName": "Jackson",
"painYesNo": "true"
}

Use the standard JSON.stringify() function to properly send JSON as a string parameter.

Once the patient has opened and submitted their form, the submissionUrl is no longer valid and cannot be accessed. Use the Get Submission endpoint to see their submitted data.

Last updated