> ## Documentation Index > Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt > Use this file to discover all available pages before exploring further. # Initiate New Submission > Initiate a new submission for processing. Supports sending in one or multiple documents at once, or a single .eml file. ## OpenAPI ````yaml https://vision.staging.pingintel.com/api/schema/?format=json post /api/v1/submission openapi: 3.0.3 info: title: Ping.Vision API version: v1.0 description: > ### Ping.Vision API This API provides convenient, efficient access to Ping Intel's data and services. It is designed to be used by developers and data scientists to integrate Ping Intel's capabilities into their applications. Once SSO is set up with your organization, you can create an Organization or Personal API key at https://auth.pingintel.com/org. Please see the Python client library [pingintel-api](https://pypi.org/project/pingintel-api/) for commandline tools and programmatic access, and you can refer to the following documentation for details on interacting with the system via the HTTP API. contact: email: support@pingintel.com name: Ping Intel url: https://www.pingintel.com servers: - url: https://vision.pingintel.com description: Ping.Vision API - url: https://vision.staging.pingintel.com description: Ping.Vision API (staging) security: [] tags: - name: Create Submission description: The Create Submission API allows you to add new data into the system. - name: Update Submission description: >- The Update Submission API provides various endpoints to update, modify, or act upon existing submissions. - name: Get Submission Data description: '' - name: User Memberships description: >- The User Memberships API allows you to add, remove, and change the role of users in different teams, divisions, or companies. - name: Miscellaneous description: '' paths: /api/v1/submission: post: tags: - Create Submission summary: Initiate New Submission description: >- Initiate a new submission for processing. Supports sending in one or multiple documents at once, or a single .eml file. operationId: api_v1_submission_create requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/CreateSubmission' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/InitiateSubmissionResponseCreated' description: '' '400': content: application/json: schema: $ref: '#/components/schemas/InitiateSubmissionErrorResponse' description: '' '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' description: '' '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse403' description: '' security: - authorization_header: [] components: schemas: CreateSubmission: type: object properties: files: type: array items: type: string format: uri description: A list of files to be uploaded. cc_emails: type: array items: type: string format: email description: >- List of email addresses to CC on email notifications for this submission. client_ref: type: string nullable: true description: Client reference identifier. expiration_date: type: string format: date nullable: true description: Date when the insurance policy should terminate. inception_date: type: string format: date nullable: true description: Date when the insurance policy was/will be/is targeted to begin. insured_name: type: string nullable: true description: Name of the insured. is_rush: type: boolean default: false description: Whether this submission should be treated as a rush submission. need_by_date: type: string format: date nullable: true description: Date by which the submission is needed. new_renewal: enum: - New - Renewal - null type: string x-spec-enum-id: 78c0846a92a6c1eb nullable: true description: |- Whether the submission is for a new policy or a renewal. * `New` - New * `Renewal` - Renewal notify_complete: type: boolean default: false description: >- Whether to send an email notification when the submission processing is complete. Defaults to False for API submissions. notify_received: type: boolean default: false description: >- Whether to send an email notification when the submission is received. Defaults to False for API submissions. risk_summary: type: string nullable: true description: Risk summary of the insured target_terms: type: string nullable: true description: Optional target terms entered by the broker/user. team_uuid: type: string format: uuid nullable: true description: >- UUID of the team to which the submission should be sent. Required if the API user has access to create submissions for multiple teams. required: - files InitiateSubmissionResponseCreated: type: object properties: id: type: string description: >- Newly-created `pingid`. Use this as the identifier for future requests. message: type: string description: Server message indicating the request was successful. url: type: string description: URL to the submission. Use this to view the submission in the UI. required: - id - message - url InitiateSubmissionErrorResponse: type: object properties: message: type: string description: Server error message detail ErrorResponse401: type: object properties: id: type: string format: uuid description: Request ID message: type: string description: Authorization error message. required: - id - message ErrorResponse403: type: object properties: detail: type: string description: Error message. required: - detail securitySchemes: authorization_header: type: apiKey in: header name: Authorization description: >- Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based authentication. ````