---
title: "Create Form"
method: POST
path: "/api/v1/form"
tags: ["Form"]
---

# Create Form

`POST /api/v1/form`

Create a new form

## Request body

- IFormCreate
  - `org_id` string, uuid, nullable
  - `name` string, nullable, required
  - `trigger_instructions` string, nullable, required
  - `form_type` 'natural' | 'simple', required
  - `attributes` object
  - `fields` unknown[]
    - unknown
  - `webhook_id` string, uuid, nullable
  - `trigger_tools` unknown[], nullable
    - unknown
  - `contact_mapping` object, nullable

## Response `201`

Successful Response

- IPostResponseBaseIFormCreate
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` IFormCreate
    - `org_id` string, uuid, nullable
    - `name` string, nullable, required
    - `trigger_instructions` string, nullable, required
    - `form_type` 'natural' | 'simple', required
    - `attributes` object
    - `fields` unknown[]
      - unknown
    - `webhook_id` string, uuid, nullable
    - `trigger_tools` unknown[], nullable
      - unknown
    - `contact_mapping` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/insighto/apis/ragify.md) · [All operations](https://skmtc.net/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insighto/ragify/versions/cdca56191be9/schema)