> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-form-submissions/introduction.md

## Article Content:

# About the Intake Form Submissions API

The Intake Form Submissions API lets you manage submissions for [intake forms](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-forms/introduction.md).
A submission represents a contact's completion of an intake form, with status tracking, expiration management, and lifecycle operations.

With the Intake Form Submissions API, you can:

- Query, search, and count intake form submissions, and retrieve the most recent submission per contact.
- Identify forms without submissions.
- Extend expiration dates, cancel submissions, or exempt contacts from submitting forms.

## Before you begin

It's important to note the following points before starting to code:

- The Wix Forms app isn't required.
- You can create intake form submissions in 2 ways:
  - Generate a link with [Create Customer Submission Link](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-forms/create-customer-submission-link.md) for customers to complete forms themselves.
  - Call Wix Forms' [Create Submission](https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md) to create a submission programmatically on behalf of a customer.
- A submission's expiration date is calculated from the creation date plus the intake form's expiration period in months.
  When a submission expires, or you cancel it, it remains in the system for record-keeping.
- When you extend a submission, you reset the expiration date to keep it valid for another expiration period.
- When an intake form is deleted, its submissions become orphaned. Orphaned submissions aren't returned by any of this API's methods.
- [List Intake Form Data By Contacts](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-form-submissions/list-intake-form-data-by-contacts.md) returns both intake forms without submissions and the most recent submission per contact. This allows you to easily validate intake form requirements for a group of contacts.

## Use cases

- [Send intake forms to customers who haven't completed them](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/sample-flows.md#send-intake-forms-to-customers-who-havent-completed-them).
- [Approve all forms for a customer group](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/sample-flows.md#approve-all-forms-for-a-customer-group).
- [Create a submission on behalf of a customer](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/sample-flows.md#create-a-submission-on-behalf-of-a-customer).
- [Extend submission expiration dates](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-form-submissions/sample-flows.md#extend-submission-expiration-dates).

## Terminology

- **Intake form submission**: A record representing a contact's completion of an intake form. Each submission has one of these statuses: `VALID`, `EXPIRED`, `CANCELED`, `EXTENDED`, or `EXEMPT`.
- **Expiration date**: The date and time when a submission expires. Calculated from the creation date plus the intake form's expiration period, but can be manually extended.
- **Extend submission**: Resetting a submission's expiration date to keep it valid for another expiration period. Changes the status from `EXPIRED` back to `VALID`.
- **Cancel submission**: Marking a submission as invalid by changing its status to `CANCELED`. The submission remains in the system for record-keeping.
- **Exempt submission**: Marking a contact as exempt from submitting a form. Creates a submission with status `EXEMPT`.

## See also

- [Intake Forms API](https://dev.wix.com/docs/api-reference/crm/forms/other-services/intake-forms/intake-forms/introduction.md)
- [Wix Forms API](https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/introduction.md)

@sdk_package_setup