# /smartlists

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Formstack API v2025.0",
    "version": "0.0.4"
  },
  "servers": [
    {
      "url": "https://www.formstack.com/api/v2025",
      "description": "Production server"
    },
    {
      "url": "https://staging-formstack.com/api/v2025",
      "description": "Staging server"
    },
    {
      "url": "https://dev-formstack.com/api/v2025",
      "description": "Development server"
    }
  ],
  "paths": {
    "/smartlists": {
      "post": {
        "tags": [
          "Smart List"
        ],
        "operationId": "createSmartList",
        "requestBody": {
          "description": "Smart list data",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSmartListInputApiDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Smart List created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SmartListDetailedApiDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid input data"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SmartListDetailedApiDto": {
        "title": "Smart List Details",
        "description": "Smart List details response",
        "properties": {
          "id": {
            "description": "The ID of the smart list",
            "type": "integer",
            "nullable": false
          },
          "name": {
            "description": "Name of the smart list",
            "type": "string",
            "nullable": false
          },
          "useImages": {
            "description": "Whether the smart list uses images",
            "type": "boolean",
            "nullable": false
          },
          "useSeparateValues": {
            "description": "Whether the smart list uses separate values",
            "type": "boolean",
            "nullable": false
          },
          "created": {
            "description": "Date when the smart list was created (ISO 8601 format)",
            "type": "string",
            "format": "date-time",
            "example": "2023-12-01T10:30:00Z",
            "nullable": false
          },
          "updated": {
            "description": "Date when the smart list was last updated (ISO 8601 format)",
            "type": "string",
            "format": "date-time",
            "example": "2023-12-01T15:45:00Z",
            "nullable": false
          }
        },
        "type": "object"
      },
      "CreateSmartListInputApiDto": {
        "title": "Create Smart List",
        "description": "Create Smart List request",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "description": "Name of the smart list",
            "type": "string",
            "maxLength": 255,
            "example": "My Smart List",
            "nullable": false
          },
          "useImages": {
            "description": "Whether the smart list should use images for options",
            "type": "boolean",
            "default": false,
            "nullable": false
          },
          "useSeparateValues": {
            "description": "Whether the smart list should use separate values for options",
            "type": "boolean",
            "default": false,
            "nullable": false
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Smart List",
      "description": "Smart Lists are reusable sets of options that can be shared across fields and forms, so option sets are maintained in one place rather than per field. Use these endpoints to list smart lists and to create, retrieve, update, and delete a smart list."
    }
  ]
}
```