---
title: "POST /v1/flow-templates"
method: POST
path: "/v1/flow-templates"
tags: ["flow-templates"]
---

# POST /v1/flow-templates

`POST /v1/flow-templates`

Create a flow template

## Request body

- object
  - `description` string
  - `template` object, required
    - `displayName` string, required
    - `trigger` union, required
      - object
        - `name` string, required
        - `valid` boolean, required
        - `displayName` string, required
        - `nextAction` unknown
        - `type` 'PIECE_TRIGGER', required
        - `settings` object, required
          - `pieceName` string, required
          - `pieceVersion` string, required
          - `pieceType` union, required
            - 'CUSTOM'
            - 'OFFICIAL'
          - `packageType` union, required
            - 'ARCHIVE'
            - 'REGISTRY'
          - `triggerName` string
          - `input` object, required
          - `inputUiInfo` object, required
            - `sampleDataFileId` string
            - `lastTestDate` string
            - `customizedInputs` object
            - `currentSelectedData` unknown
      - object
        - `name` string, required
        - `valid` boolean, required
        - `displayName` string, required
        - `nextAction` unknown
        - `type` 'EMPTY', required
        - `settings` unknown, required
    - `valid` boolean, required
    - `schemaVersion` string, nullable
  - `blogUrl` string
  - `type` union, required
    - 'PLATFORM'
    - 'PROJECT'
  - `tags` string[]
  - `id` string

## Response `200`

Default Response

## Changes

- **2024-11-12** `499ae054e9e9` — 2 info
  - added the new optional request property `template/schemaVersion`
  - added the new optional request property `template/trigger/anyOf[subschema #1]/settings/inputUiInfo/sampleDataFileId`
- **2024-09-13** `225ff954244e` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2024-09-09** `b04deb48df4b` — 1 info
  - endpoint added
- **2023-12-03** `7b0cc60eed56` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/changes/v1/flow-templates/post.md)

---

[API](https://skmtc.dev/activeboxes/apis/activeboxes-documentation.md) · [All operations](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activeboxes/activeboxes-documentation/revisions/12c564515962/schema)