---
title: "Create Field Configuration"
method: POST
path: "/field-configurations"
tags: ["Field Configuration"]
---

# Create Field Configuration

`POST /field-configurations`

Creates a new field configuration owned by the authenticated organization. The owning organization is inferred from the API key and any organization UUID supplied on the body is ignored.

## Request body

- CreateFieldConfigurationRequest — Request payload for creating a new field configuration. The owning organization is inferred from the API key - any organization UUID included in the body is ignored.
  - `name` string, required — Human-readable name of the configuration. Trimmed; 1-128 characters.
  - `teamsUUID` string[] — UUIDs of the teams to assign this configuration to. Ignored when `allTeams` is true.
  - `allTeams` boolean — When true, the configuration applies to every team in the organization.
  - `criteria` FieldConfigurationCriteria — Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.
    - `conditions` FieldConfigurationCriteriaCondition[] — Ordered list of conditions to evaluate.
      - `field` string — Name of the field the condition applies to.
      - `value` string — Value the field must match for this condition.
    - `operator` 'AND' | 'OR' — Boolean operator used to combine the conditions.

## Response `201`

Field configuration created successfully.

- FieldConfigurationResponse — Envelope containing a single field configuration.
  - `data` FieldConfiguration — A Field Configuration (internally `IntelligenceItemCollection`) groups a set of intelligence items that are surfaced together for the teams it is assigned to. Field Configurations are scoped to a single organization.
    - `uuid` string, required — Unique identifier of the field configuration.
    - `name` string, required — Human-readable name of the field configuration.
    - `organizationUUID` string, required — UUID of the organization the field configuration belongs to.
    - `teamsUUID` string[], required — UUIDs of the teams this field configuration is assigned to. Ignored when `allTeams` is true.
    - `allTeams` boolean, required — When true, this configuration applies to every team in the organization and `teamsUUID` is ignored.
    - `isDefaultTemplate` boolean, required — Whether this configuration is the organization's default template.
    - `criteria` FieldConfigurationCriteria — Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.
      - `conditions` FieldConfigurationCriteriaCondition[] — Ordered list of conditions to evaluate.
        - `field` string — Name of the field the condition applies to.
        - `value` string — Value the field must match for this condition.
      - `operator` 'AND' | 'OR' — Boolean operator used to combine the conditions.
    - `createdAt` string, date-time, required — Timestamp when the configuration was created.

## Other responses

- `400` — Invalid or missing fields on the request body.
- `401` — Authentication failed. Please provide a valid API key.
- `409` — A field configuration with the same name already exists in the organization.
- `422` — Schema-level validation failure on the request body (e.g. required field missing or value outside the allowed length range).
- `default` — Unexpected error.

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)