Skip to main content
POST
/
field-configurations
Create Field Configuration
curl --request POST \
  --url https://api.attention.tech/v2/field-configurations \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Enterprise Discovery Questions",
  "teamsUUID": [
    "fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
  ],
  "allTeams": false,
  "criteria": {
    "conditions": [
      {
        "field": "account.industry",
        "value": "technology"
      }
    ],
    "operator": "AND"
  }
}
'
{
  "data": {
    "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
    "name": "Enterprise Discovery Questions",
    "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
    "teamsUUID": [
      "fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
    ],
    "allTeams": false,
    "isDefaultTemplate": false
  }
}

Authorizations

​
Authorization
string
header
required

Body

Field configuration to create.

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.

Example:

"Enterprise Discovery Questions"

​
teamsUUID
string[]

UUIDs of the teams to assign this configuration to. Ignored when allTeams is true.

Example:
["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"]
​
allTeams
boolean

When true, the configuration applies to every team in the organization.

Example:

false

​
criteria
object

Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.

Example:
{
  "conditions": [
    {
      "field": "account.industry",
      "value": "technology"
    }
  ],
  "operator": "AND"
}

Response

Field configuration created successfully.

Envelope containing a single field configuration.

​
data
object

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.

Example:
{
  "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
  "name": "Enterprise Discovery Questions",
  "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
  "teamsUUID": ["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"],
  "allTeams": false,
  "isDefaultTemplate": false,
  "criteria": {
    "conditions": [
      {
        "field": "account.industry",
        "value": "technology"
      }
    ],
    "operator": "AND"
  },
  "createdAt": "2026-03-01T12:00:00Z"
}