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

# Crear campo adicional

`POST /custom-fields`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/custom-fields`
- Auth: HTTP basic

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/inventario.md) - [All operations](https://skmtc.dev/alegra/apis/inventario/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/inventario/revisions/d1a516b653a1?raw)