---
title: "Get Input Fields"
method: POST
path: "/v2/actions/{action_id}/inputs"
tags: ["Actions", "Inputs"]
---

# Get Input Fields

`POST /v2/actions/{action_id}/inputs`

Get the Input Fields for a particular Action, using the provided authentication and inputs. See the fields and fieldsets guide for more information.
See [our docs](https://docs.zapier.com/powered-by-zapier/zap-creation/fields-and-fieldsets#input-fields) for more information.

#### When using OAuth

This endpoint requires the `zap:write` OAuth scope.

## Path parameters

- `action_id` string, required

## Request body

- ListInputFieldsRequest — Common inputs with inputs and an authentication id.
  - `data` ListInputFieldsRequest, required — recursive

## Response `200`

- InputFieldsResponse — A successful response for getting the input fields for a particular Action.
  - `links` Links, required — The links object returned in paginated response bodies.
    - `next` string, nullable — The URL of the next page of paginated results.
    - `prev` string, nullable — The URL of the previous page of paginated results.
  - `meta` BaseMeta, required — The meta object returned in paginated response bodies.
    - `count` integer, required — The total number of objects in the collection represented by the endpoint.
    - `limit` integer, nullable, required — The limit value used in the request.
    - `offset` integer — The offset value used in the request.
  - `data` union[], required — The base concept of a Fieldset, from which others extend
    - union
      - InputField — Represents Input Field data as accepted by the API
        - `type` string, required — The type of Input Field
        - `id` string, required — The identifier for this Input Field
        - `default_value` string, required — The default value for this Input Field if not otherwise specified
        - `depends_on` string[], required — A list of dependencies for this Input Field
        - `description` string, required — The description of this Input Field
        - `format` 'DATETIME' | 'MULTILINE' | 'PASSWORD' | 'CODE' | 'READONLY' | 'FILE' | 'SELECT', required — * `DATETIME` - DATETIME * `MULTILINE` - MULTILINE * `PASSWORD` - PASSWORD * `CODE` - CODE * `READONLY` - READONLY * `FILE` - FILE * `SELECT` - SELECT
        - `invalidates_input_fields` boolean, required — Whether this Input Field invalidates
        - `is_required` boolean, required — Whether this Input Field is required
        - `items` object, required — A freeform object of items for this Input Field
        - `placeholder` string, required — The placeholder for this Input Field when shown
        - `title` string, required — The title of this Input Field
        - `value_type` 'STRING' | 'NUMBER' | 'INTEGER' | 'BOOLEAN' | 'ARRAY' | 'OBJECT', required — * `STRING` - STRING * `NUMBER` - NUMBER * `INTEGER` - INTEGER * `BOOLEAN` - BOOLEAN * `ARRAY` - ARRAY * `OBJECT` - OBJECT
      - InfoField — Represents an Info-type Fieldset
        - `type` string, required — The type of this Info Field
        - `id` string, required — The identifier of this Info Field
        - `description` string, required — The description for this Info Field
      - Fieldset — Represents a Fieldset
        - `type` string, required — The type of this Fieldset
        - `id` string, required — The unique identifier for this Fieldset
        - `fields` union, required — Somewhat confusingly named, a field that is a list of either input fields or info fields.
          - InputField — Represents Input Field data as accepted by the API
            - `type` string, required — The type of Input Field
            - `id` string, required — The identifier for this Input Field
            - `default_value` string, required — The default value for this Input Field if not otherwise specified
            - `depends_on` string[], required — A list of dependencies for this Input Field
            - `description` string, required — The description of this Input Field
            - `format` 'DATETIME' | 'MULTILINE' | 'PASSWORD' | 'CODE' | 'READONLY' | 'FILE' | 'SELECT', required — * `DATETIME` - DATETIME * `MULTILINE` - MULTILINE * `PASSWORD` - PASSWORD * `CODE` - CODE * `READONLY` - READONLY * `FILE` - FILE * `SELECT` - SELECT
            - `invalidates_input_fields` boolean, required — Whether this Input Field invalidates
            - `is_required` boolean, required — Whether this Input Field is required
            - `items` object, required — A freeform object of items for this Input Field
            - `placeholder` string, required — The placeholder for this Input Field when shown
            - `title` string, required — The title of this Input Field
            - `value_type` 'STRING' | 'NUMBER' | 'INTEGER' | 'BOOLEAN' | 'ARRAY' | 'OBJECT', required — * `STRING` - STRING * `NUMBER` - NUMBER * `INTEGER` - INTEGER * `BOOLEAN` - BOOLEAN * `ARRAY` - ARRAY * `OBJECT` - OBJECT
          - InfoField — Represents an Info-type Fieldset
            - `type` string, required — The type of this Info Field
            - `id` string, required — The identifier of this Info Field
            - `description` string, required — The description for this Info Field
        - `title` string, required — The title of this Fieldset

## Other responses

- `400` — This schema can be expected for 4xx 'Malformed request.' errors
- `401` — 401 Response
- `403` — 403 Response
- `409` — 409 Response
- `429` — 429 Response
- `500` — This schema can be expected for 5xx 'A server error occurred.' errors
- `503` — 503 Response
- `504` — 504 Response

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)