---
title: "Store a form instance"
method: POST
path: "/form/form-instances"
tags: ["Form Instances"]
---

# Store a form instance

`POST /form/form-instances`

## Request

- Base URL: `http://localhost:8090/form-api`
- URL: `http://localhost:8090/form-api/form/form-instances`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-form-rest-api/docs/form/form-instances/post.ts> (a function with typed inputs; its response is checked against the schema)

Provide either a FormDefinitionKey or a FormDefinitionId together with the other properties.

## Request body

- FormRequest
  - `formInstanceId` string
  - `formDefinitionId` string
  - `formDefinitionKey` string
  - `taskId` string
  - `processInstanceId` string
  - `processDefinitionId` string
  - `scopeId` string
  - `scopeType` string
  - `scopeDefinitionId` string
  - `outcome` string
  - `tenantId` string
  - `parentDeploymentId` string
  - `variables` object

## Response `201`

Indicates the form instance was stored.

## Other responses

- `404`: Indicates the related form model was not found.

---

[API](https://skmtc.dev/flowable/apis/flowable-form-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-form-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-form-rest-api/revisions/e581eab990c1?raw)