Crear una categoría de egreso
Un negocio nace con once categorías por defecto y puede crear las suyas.
Crear categorías propias es una función aparte del módulo de egresos (expense_categories_custom): en el plan más bajo se usan solo las que vienen.
Autorización
apiKey categories.writeLa llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».
Va en: header
Permiso: categories.write
Parámetros de consulta
Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios; con uno solo, se deduce.
Cuerpo de la petición
application/json
Tipos de TypeScript
Usa el tipo request body en TypeScript.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/expense-categories" \ -H "Content-Type: application/json" \ -d '{ "name": "Publicidad y pauta", "emoji": "📣", "description": "Meta Ads, volantes, pauta local" }'{ "object": "expenseCategory", "id": "cmtnqe1yi0000w6w1712cnrxp", "name": "Publicidad y pauta", "description": "Meta Ads, volantes, pauta local", "emoji": "📣", "color": null, "active": true, "displayOrder": 120}Listar categorías de egreso GET
Las categorías del negocio, para poder mandar un categoryId válido al crear un egreso. Solo lectura, a propósito. Un ERP con su propio catálogo llenaría el libro de categorías duplicadas sin querer, y el dueño ya las administra en el panel, donde las ve todas de una vez.
Editar una categoría de egreso PATCH
Renombrar, cambiar el emoji o la descripción, reordenar — y desactivar, que es lo que se hace con una categoría que ya tiene gastos.