ALalegra
Items

Listar campos adicionales

Herramienta MCP: customFields_getCustomFields.

Devuelve la lista de campos adicionales de la compañía, con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "customFields_getCustomFields",
    "arguments": { "start": 0, "limit": 30 }
  }
}

Úsala para descubrir los campos adicionales disponibles o buscar uno por nombre cuando no conoces su ID. Si ya conoces el ID, prefiere customFields_getCustomField: es más rápida y devuelve datos más completos.

fields admite valores separados por comas: editable (verificar si se puede modificar), deletable (verificar si se puede eliminar) y status. order_field y order_direction solo se envían cuando el usuario pide explícitamente un orden.

Paginación con start (desplazamiento desde 0) y limit (cantidad de resultados por página; no la superes por encima de 30, que es el máximo permitido). Con metadata: true la respuesta se envuelve como { data: [...], metadata: { total } }.

Solo lectura.

post/tools/customFields_getCustomFields

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/customFields_getCustomFields
  • Auth
    HTTP bearer

Request body

metadataboolean

Si es true, la respuesta se envuelve como { data: [...], metadata: { total } }.

limitinteger

Cantidad de resultados por página. No la superes por encima de 30: es el máximo permitido.

startinteger

Desplazamiento de paginación (desde 0).

order_direction'ASC' | 'DESC'

Dirección del orden. Por defecto ASC.

order_fieldstring

Campo por el que ordenar. Por defecto name.

status'active' | 'inactive'

Filtra los campos adicionales por estado.

namestring

Busca o filtra los campos adicionales por nombre.

fieldsstring

Campos extra separados por comas: deletable, editable, status.

Response

Lista de campos adicionales

Changes

No recorded changes to this operation across all 1 revision of this API.