---
title: API REST – Listas desplegables (Picklist)
description: "--- ## GetPicklistValues — Recuperar los valores Recupera la lista de valores disponibles para un campo de tipo lista desplegable (picklist) de un módulo. > **GET** `https://apps.kafinea.com/{instance}/webservice.php` | Parámetro | Tipo | Obligatorio | Descripción | | --- | ---…"
url: "https://www.kafinea.com/es/documentacion/api/api-rest-listas-desplegables-picklist/"
updated: "2026-04-03"
category: API
---

# API REST – Listas desplegables (Picklist)

---

## GetPicklistValues — Recuperar los valores

Recupera la lista de valores disponibles para un campo de tipo lista desplegable (picklist) de un módulo.

> **GET** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `getPicklistValues` |
| `sessionName` | string | sí | Identificador de sesión |
| `moduleName` | string | sí | Nombre del módulo (p. ej.: `Accounts`, `Leads`) |
| `fieldName` | string | sí | Nombre técnico del campo |

**Ejemplo curl:**

```bash
curl "https://apps.kafinea.com/YourKafinea/webservice.php?operation=getPicklistValues&sessionName=YOUR_SESSION_ID&moduleName=Accounts&fieldName=industry"
```

---

## SetPicklistValues — Modificar los valores

Actualiza la lista de opciones disponibles para un campo de tipo lista desplegable.

> **⚠️ ¡Atención!** Esta operación **reemplaza la totalidad** de los valores existentes por la lista proporcionada. Los valores antiguos no incluidos en la nueva lista se perderán.

> **POST** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `setPicklistValues` |
| `sessionName` | string | sí | Identificador de sesión |
| `moduleName` | string | sí | Nombre del módulo afectado |
| `fieldName` | string | sí | Nombre técnico del campo que se va a modificar |
| `values` | JSON | sí | Array JSON de las nuevas opciones (p. ej.: `["Banque", "Tech"]`) |

**Ejemplo curl:**

```bash
curl -X POST https://apps.kafinea.com/YourKafinea/webservice.php 
  -d "operation=setPicklistValues" 
  -d "sessionName=YOUR_SESSION_ID" 
  -d "moduleName=Accounts" 
  -d "fieldName=industry" 
  -d 'values=["Banque","Tech","Santé"]'
```

---

## Referencias asociadas 🔗

- [Operaciones CRUD](https://www.kafinea.com/es/documentation/api/api-rest-operaciones-crud/)
- [Introducción a la API](https://www.kafinea.com/es/documentation/api/api-rest-introduccion/)
