---
title: "Criar campo"
method: POST
path: "/fields"
tags: ["Fields"]
---

# Criar campo

`POST /fields`

Cria um novo campo.

## Request body

- object
  - `name` string, required — Nome do campo
  - `description` string, required — Descrição do campo
  - `type` 'text' | 'email' | 'phone' | 'number' | 'url' | 'boolean' | 'date' | 'choice' | 'multi_choice' | 'cpf' | 'cnpj' — Tipo do campo
  - `options` string[] — Lista de opções para campos do tipo `choice` ou `multi_choice`

## Response `200`

Successful response

- object
  - `id` string, required — Identificador único do campo
  - `name` string, required — Nome do campo
  - `description` string, required — Descrição do campo
  - `active` boolean — Indica se o campo está ativo
  - `fixed` boolean
  - `type` 'text' | 'email' | 'phone' | 'number' | 'url' | 'boolean' | 'date' | 'choice' | 'multi_choice' | 'cpf' | 'cnpj' — Tipo do campo
  - `options` string[] — Lista de opções para campos do tipo `choice` ou `multi_choice`
  - `new` boolean — Flag de compatibilidade (integrações)
  - `workspaceId` string, required — Identificador do workspace associado
  - `createdBy` string, nullable, required — ID do usuário que criou o registro
  - `updatedBy` string, nullable, required — ID do usuário que atualizou o registro
  - `createdAt` string, date-time — Data de criação
  - `updatedAt` string, date-time — Data da última atualização

## Other responses

- `default` — Error response

## Changes

- **2026-08-27** `e97f27faa8ce` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-27T01:02:45.170Z` to `2026-08-27T20:04:00.491Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-27T01:02:45.170Z` to `2026-08-27T20:04:00.491Z` for the status `200`
- **2026-08-27** `a0049b6eb1ae` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-26T06:02:23.522Z` to `2026-08-27T01:02:45.170Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-26T06:02:23.522Z` to `2026-08-27T01:02:45.170Z` for the status `200`
- **2026-08-26** `00b499142b2d` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-25T11:01:57.707Z` to `2026-08-26T06:02:23.522Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-25T11:01:57.707Z` to `2026-08-26T06:02:23.522Z` for the status `200`
- **2026-08-25** `caf977e45e84` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-24T16:01:59.653Z` to `2026-08-25T11:01:57.707Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-24T16:01:59.653Z` to `2026-08-25T11:01:57.707Z` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/rdstationmentoria/apis/agents/changes/fields/post.md)

---

[API](https://skmtc.dev/rdstationmentoria/apis/agents.md) · [All operations](https://skmtc.dev/rdstationmentoria/apis/agents/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rdstationmentoria/agents/revisions/e97f27faa8ce/schema)