# Create a TrueFlow

Creates a new TrueFlow from a template

Endpoint: POST /v1/true-flows
Version: 0.9.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `name` (string)
    Name of the TrueFlow

  - `expires_at` (string)
    Expiration date/time for the TrueFlow (ISO 8601)

  - `template_token` (string, required)
    Token of the flow template to use

  - `flow_data` (object)
    Key-value data for the flow form (keys and values depend on template)

  - `sign_data` (array)
    Array of signer data objects (e.g. signer_email, signer_name per item)

## Response 201 fields (application/json):

  - `token` (string, required)
    Unique identifier for the TrueFlow

  - `trueLink` (string, required)
    Deep link url to the TrueFlow

## Response 400 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type.
    Example: "https://api.truescreen.io/errors/validation-error"

  - `title` (string, required)
    Short, human-readable summary of the problem.
    Example: "Validation failed"

  - `status` (integer)
    HTTP status code.
    Example: 400

  - `detail` (string)
    Human-readable explanation specific to this occurrence.
    Example: "One or more fields have invalid values"

  - `code` (string, required)
    Unique code to identify the error.
    Example: "TS-000"

  - `instance` (string)
    URI reference that identifies the specific occurrence.
    Example: "https://api-stg-truescreen.io/special-events"

## Response 500 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type.
    Example: "https://api.truescreen.io/errors/validation-error"

  - `title` (string, required)
    Short, human-readable summary of the problem.
    Example: "Validation failed"

  - `status` (integer)
    HTTP status code.
    Example: 400

  - `detail` (string)
    Human-readable explanation specific to this occurrence.
    Example: "One or more fields have invalid values"

  - `code` (string, required)
    Unique code to identify the error.
    Example: "TS-000"

  - `instance` (string)
    URI reference that identifies the specific occurrence.
    Example: "https://api-stg-truescreen.io/special-events"