Create a new form submission
POST/forms/submissions
Creates a new form submission. When createPractitioner is true, also creates or links a practitioner (using data.practitionerData) and a portal crosswalk; returns the form submission response with certifyId and providerCreated. Form submission is created first; on failure the request fails without creating a practitioner.
Request
Responses
- 201
- 400
- 401
- 403
- 500
Form submission created successfully. When createPractitioner is true, the response includes all form submission fields plus certifyId (tenant crosswalk identifier) and providerCreated (true if a new practitioner was created, false if the practitioner already existed).
Bad request: invalid or missing request body, or when createPractitioner is true: missing data, missing practitionerData, or practitionerData missing npi/externalId.
Unauthorized: valid JWT is required.
Forbidden: insufficient permissions.
Internal server error: unexpected failure during form submission or practitioner/crosswalk operations.