---
title: "Create Time Field"
method: POST
path: "/v3.0/fields/time/"
tags: ["fields"]
---

# Create Time Field

`POST /v3.0/fields/time/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/fields/time/`
- Auth: none declared. Required headers: `x-api-key`

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- TimeFieldRequest
  - `form` string, nullable: slug of the form to which this field will be added.
  - `repeating_section` string, nullable: slug of the repeating section field on which this field will be added.
  - `title` string, nullable: field title or label to be shown to user. (e.g. "your contact email")
  - `alias` string, nullable: a user-defined slug to identify the field, which is unique form-wide, unless null.
  - `description` string, nullable: extra info on the field (if any). (e.g. "please use the email account you always check.")
  - `answer_description` string, nullable: any description on this question and it's answers.
  - `position` integer: the order of the field on the form. (e.g. 2)
  - `required` boolean: is the field required?
  - `unique` boolean: should the submitted value be unique for the form?
  - `availability_limit_per_answer` integer: the maximum number of times an answer can be submitted.
  - `admin_only` boolean: if set true, it will be set as admin only, and end users won't be able to see/submit it.
  - `read_only` boolean: if set true, it will be set as read only, and end users won't be able to submit it.
  - `json_key` string, nullable: A string to represent the field value in a json output.
  - `is_random_sortable` boolean: if value is True, can randomly sort this field
  - `from_time` string, time, nullable: minimum acceptable time
  - `to_time` string, time, nullable: maximum acceptable time

## Response `201`

- TimeField
  - `slug` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `is_global` string
  - `form` string, nullable: slug of the form to which this field will be added.
  - `repeating_section` string, nullable: slug of the repeating section field on which this field will be added.
  - `type` 'generic_field' | 'short_text' | 'long_text' | 'regex' | 'yes_no' | 'checkbox' | 'choice' | 'dropdown' | 'multiple_select' | 'choice_fetch' | 'table' | 'repeating_section' | 'matrix' | 'website' | 'email' | 'phone' | 'email_verification' | 'meta' | 'oembed' | 'success_page' | 'file' | 'signature' | 'hidden' | 'city' | 'country' | 'number' | 'product' | 'rating' | 'lookup' | 'linked_rows' | 'time' | 'date' | 'user' | 'profile' | 'profile_data' | 'assignee' | 'variable'
  - `title` string, nullable: field title or label to be shown to user. (e.g. "your contact email")
  - `alias` string, nullable: a user-defined slug to identify the field, which is unique form-wide, unless null.
  - `description` string, nullable: extra info on the field (if any). (e.g. "please use the email account you always check.")
  - `answer_description` string, nullable: any description on this question and it's answers.
  - `position` integer: the order of the field on the form. (e.g. 2)
  - `required` boolean: is the field required?
  - `unique` boolean: should the submitted value be unique for the form?
  - `availability_limit_per_answer` integer: the maximum number of times an answer can be submitted.
  - `admin_only` boolean: if set true, it will be set as admin only, and end users won't be able to see/submit it.
  - `read_only` boolean: if set true, it will be set as read only, and end users won't be able to submit it.
  - `json_key` string, nullable: A string to represent the field value in a json output.
  - `is_random_sortable` boolean: if value is True, can randomly sort this field
  - `from_time` string, time, nullable: minimum acceptable time
  - `to_time` string, time, nullable: maximum acceptable time

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)