---
title: "Import a submission"
method: POST
path: "/v4/submissions"
tags: ["Submissions"]
---

# Import a submission

`POST /v4/submissions`

## Request body

- union
  - CreateSubmissionBySubmitterIdRequest
    - `projectId` string, uuid, required
    - `fieldData` union[], required
      - union
        - TitleFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NameFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - AddressFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ShortAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - LongAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FileUploadFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TableFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NumberFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DateFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EmailFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - WebsiteFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - PhoneFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CoverLetterFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TextOnlyFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ReferenceFormFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DividerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityCharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityDropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - BankDetailsFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FraudPreventionResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SsnItinResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EinFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - UeiFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DisclosureFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ESignResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
    - `governmentId` string, nullable
  - CreateSubmissionByEmailRequest
    - `projectId` string, uuid, required
    - `fieldData` union[], required
      - union
        - TitleFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NameFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - AddressFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ShortAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - LongAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FileUploadFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TableFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NumberFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DateFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EmailFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - WebsiteFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - PhoneFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CoverLetterFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TextOnlyFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ReferenceFormFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DividerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityCharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityDropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - BankDetailsFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FraudPreventionResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SsnItinResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EinFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - UeiFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DisclosureFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ESignResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
    - `governmentId` string, nullable
  - CreateSubmissionByNameRequest
    - `projectId` string, uuid, required
    - `fieldData` union[], required
      - union
        - TitleFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NameFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - AddressFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ShortAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - LongAnswerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FileUploadFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TableFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - NumberFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DateFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EmailFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - WebsiteFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - PhoneFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CoverLetterFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - TextOnlyFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ReferenceFormFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DividerFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SingleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - MultipleRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownRatingFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - CharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityCharityCheckFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleCheckboxFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilitySingleResponseFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EligibilityDropdownListFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - BankDetailsFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - FraudPreventionResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - SsnItinResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - EinFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - UeiFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - DisclosureFieldResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
        - ESignResponseRequest
          - `fieldType` string, required
          - `formFieldId` string, required
    - `governmentId` string, nullable

## Response `201`

Created

- SubmissionResponse
  - `submissionId` string, uuid, nullable
  - `projectId` string, uuid, nullable
  - `submitterId` string, uuid, nullable
  - `submissionStatus` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', nullable
  - `isArchivedBySubmitter` boolean
  - `isArchivedByOrganization` boolean
  - `isPaid` boolean
  - `formEntries` union[], nullable
    - union
      - AnyFormTypeInitialFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeAdditionalFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeInternalFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeReferenceFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeReviewFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeEligibilityFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
      - AnyFormTypeRequestFormEntryMetadataResponse
        - `formType` 'additional' | 'initial' | 'reference' | 'review' | 'internal' | 'eligibility' | 'request', nullable, required
  - `labels` V4LabelResponse[], nullable
    - `labelId` string, nullable
    - `name` string, nullable
    - `backgroundColor` string, nullable
    - `foregroundColor` string, nullable
  - `reviewStageId` string, uuid
  - `publicOrgId` string, uuid, nullable
  - `publicOrgVersion` integer, nullable
  - `publicOrgName` string, nullable
  - `submissionTitle` string, nullable

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)