---
title: "Crear campo adicional"
method: POST
path: "/custom-fields"
tags: ["Campos adicionales"]
---

# Crear campo adicional

`POST /custom-fields`

Endpoint que permite crear un campo adicional.

## Request body

- Schema — unresolved $ref

## Response `200`

Objeto que representa la respuesta al crear un campo adicional.

- object
  - `id` string — Identificador único que representa un campo adicional específico. La aplicación lo asigna automáticamente.
  - `name` string — Indica el nombre del campo adicional
  - `description` string — Descripción del campo adicional.
  - `defaultValue` string — Indicar un valor por defecto
  - `resourceType` 'item' — Recurso asociado al campo adicional.
  - `key` string — Key para identificar si el campo es un campo de sistema. Visita la lista de campos de sistema disponibles por país [aquí](https://developer.alegra.com/docs/campos-adicionales-de-sistema).
  - `type` string — Tipo de dato del campo adicional.
  - `settings` object — Objeto con la configuraciones del campo adicional.
    - `isRequired` boolean — Indica si el campo es obligatorio o no.
    - `printOnInvoices` boolean — Indica si el campo se desea imprimir en facturas.
    - `showInItemVariants` boolean — Indica si el campo se debe usar a nivel de items variantes o a nivel de item padre en items con variantes.
  - `options` string[] — Array de strings con las opciones disponibles para el campo adicional. Únicamente aplica cuando el tipo del campo es optionsList
  - `status` 'active' | 'inactive' — Estado del campo adicional.

---

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