---
title: "Import form"
method: POST
path: "/formbuilder/forms/import"
tags: ["Form Builder"]
---

# Import form

`POST /formbuilder/forms/import`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/formbuilder/forms/import`
- Auth: none declared

Imports a single Form.

## Request body

- object
  - `form` FormbuilderFormDocument: A form document
    - `_id` string
    - `name` string, required
    - `groups` FormbuilderFormDocumentGroupsItems[]
      - union
        - string
        - object
    - `created` string, date-time
    - `created_by` unknown
    - `last_updated` string, date-time
    - `last_updated_by` unknown
    - `elements` FormbuilderFormDocumentElementsItems[], required
      - `type` string, required
      - `id` FormbuilderFormDocumentElementsItemsId, required
        - `name` string, required
    - `children` FormbuilderFormDocumentChildrenItems[], required
      - `id` string, required
      - `element` string
      - `type` string, required
      - `name` string
      - `display_name` string
      - `source_type` 'service_model' | 'custom' | 'method'
      - `source` string
      - `key` string
      - `properties` FormbuilderFormDocumentChildrenItems, required (recursive)
  - `options` FormbuilderFormsImportPostRequestBodyContentApplicationJsonSchemaOptions
    - `adapterMap` FormbuilderFormsImportPostRequestBodyContentApplicationJsonSchemaOptionsAdapterMap

## Response `200`

Import status

- boolean

## Other responses

- `500`: Error response from API

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)