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
Name | Type | Description |
---|---|---|
firstName* | String | Patient First Name |
lastName* | String | Patient Last Name |
formUuid* | String | Form UUID |
String | Patient Email Address | |
phone | String | Patient Phone Number |
sendForm* | String | "email" | "phone" | "both" |
submissionData* | JSON String | Stringified JSON data. See example below. |
appointment* | String | Must be in "YYYY-MM-DD hh:mm:ss" format. |
securityCode* | String | Security code used to open the form. |
securityCodeHint* | String | Hint provided for the security code. |
automaticReminder* | Boolean | Automatic appointment reminder. |
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
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