---
title: "Request Form Response"
method: POST
path: "/v1/form-responses"
---

# Request Form Response

`POST /v1/form-responses`

This API endpoint sends a form to client(s) for them to complete.

## Request body

- object
  - `formId` string, required — The ID of the Form to send to the recipient.
  - `clientIds` string[] — Deprecated. Use clientCompanyIds
  - `clientCompanyIds` object[], required — The list of client and company Ids for which the form is being sent to. E.g. [{ clientId: ‘client_a’, ‘companyId’: ‘company_b’}]
    - `clientId` string, required — The ID of the client to assign this form to.
    - `companyId` string, required — The ID of the company this form is associated with. One of the companies that the client is part of.

## Response `200`

200

- object
  - `allowMultipleSubmissions` boolean
  - `clientId` string
  - `createdAt` string
  - `formDescription` string
  - `formFieldIds` string[]
  - `formFields` object
    - `09c8dc93-4532-4995-831e-4bdf1c2e437b` object
      - `title` string
      - `description` string
      - `type` string
      - `multipleChoiceOptions` string[]
      - `isRequired` boolean
    - `2b7e3a5a-f335-430a-a8e9-8259c9f971d1` object
      - `title` string
      - `description` string
      - `type` string
      - `multipleChoiceOptions` string[]
      - `isRequired` boolean
    - `425fa7b8-4446-4864-8542-d9a1bdd61991` object
      - `title` string
      - `description` string
      - `type` string
      - `isRequired` boolean
    - `47741982-6b81-4041-8063-d8f825259318` object
      - `title` string
      - `description` string
      - `type` string
      - `isRequired` boolean
    - `7399360f-39f3-415f-af53-e223476b58eb` object
      - `title` string
      - `description` string
      - `type` string
      - `isRequired` boolean
    - `a9da9a50-4196-4bc6-b6a3-345f33add0ef` object
      - `title` string
      - `description` string
      - `type` string
      - `isRequired` boolean
  - `formId` string
  - `formName` string
  - `id` string
  - `object` string
  - `status` string
  - `visibility` string
  - `companyId` string
  - `updatedAt` string

## Other responses

- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/assembly/apis/core-resources.md) · [All operations](https://skmtc.net/assembly/apis/core-resources/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assembly/core-resources/versions/28a9e7d13a8c/schema)