# Create a new form submission.

Creates a new form submission.

Endpoint: POST /forms/submissions
Security: BearerAuth

## Header parameters:

  - `organization-id` (string)

## Request fields (application/json):

  - `data` (object, required)
    A flexible object for storing any data related to a form submission. This can include details about the form, the submitted data, and metadata about the submission process.

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier for the form submission.
    Example: "d453006f-30e2-4a01-841d-962579531c25"

  - `organizationId` (string)
    The unique identifier for the client organization within Certify.

  - `mappedData` (object)
    The mapped responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.
    Example: {"personalInformation":{"lastName":"Smith","firstName":"Karen","middleName":"Ann","suffix":"Jr.","npi":1010000226,"caqhId":12345678,"dateOfBirth":"1961-04-26","highmarkId":"123456789","practitionerType":"Medical Doctor","degree":"Medical Doctor","primarySpecialty":"Internal Medicine","primarySpecialtyRole":"PCP","secondarySpecialty":"Infectious Disease","secondarySpecialtyRole":"Specialist","credentialingContactEmailAddress":"credentialing@altoonaprimarycare.com","credentialingContactName":"John Doe"},"primaryPracticeLocation":{"buildingLocation":"Altoona Medical Suites","groupNpi":1010000655,"addressLine1":"Address Line 1","addressLine2":"Address Line 2","city":"Altoona","state":"PA","zip":"16601","zipExt":"1234","county":"Blair County","fips":"42013"},"credentialingAddress":{"sameAsPrimaryPracticeLocation":true,"buildingLocation":"Altoona Medical Suites","addressLine1":"Address Line 1","addressLine2":"Address Line 2","city":"Altoona","state":"PA","zip":"16601","zipExt":"1234","county":"Blair County","fips":"42013","phoneNumber":"555-555-5555","phoneExtension":"123"}}

  - `submissionData` (object)
    The raw responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.

  - `submissionPdf` (object)
    The PDF document of the form submission, if available.

  - `submittedBy` (object)
    The flexible data object containing the submitted by information.

  - `submittedBy.email` (string, required)
    The email of the user who submitted the form.

  - `submittedBy.user` (object)
    The user information of the person who submitted the form.

  - `form` (object)
    Information about the form associated with the submission.

  - `formVersionId` (string)
    The id of the version of the form used for this submission.
    Example: "e4dea7d7-6023-4c64-b0f1-777dd0266a02"

  - `createdAt` (string, required)
    The date and time when the form submission was created
    Example: "2025-01-01T12:00:00Z"

  - `createdBy` (string, required)
    The identifier of the user or system that created the submission.

  - `updatedAt` (string, required)
    The date and time when the form submission was last updated
    Example: "2025-01-01T12:00:00Z"


## Response 400 fields

## Response 401 fields

## Response 403 fields