Referencia de la APICampos PersonalizadosEmpleados
Listar
Descripcion general
Este endpoint permite obtener un listado paginado de las definiciones de campos personalizados de empleados en tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Las definiciones eliminadas se excluyen automáticamente. El tamaño de página es fijo en 20 resultados.
key es el identificador público de cada definición (snake_case, único por organización) y se usa como segmento de URL en PATCH y DELETE. select_options se devuelve como arreglo de strings (vacío o ausente cuando type no es select).
Endpoint
GET
https://app.integranom.com/api/v1/employee-custom-fieldsConsulta multiples definiciones
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
active | "true" | "false" | No | - | Filtra por el flag is_active. |
Consulta una definicion especifica
Se puede buscar una definición particular por key (snake_case, coincidencia exacta) o por type (uno de los cinco valores del enum).
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
key | string | No | - | Filtra por key exacto. |
type | text | number | date | boolean | select | No | - | Filtra por tipo de campo. |
Errores
| Status | Causa |
|---|---|
400 | Valor inválido en type (debe ser uno de los cinco valores del enum) o en active. |
401 | API key ausente o inválida. |