Actualizar campo personalizado

PUT https://app.sendapp.ai/api/contact-fields/{id}

Modifica un campo personalizado. La actualización es parcial: las claves que no envías se quedan como están. También acepta PATCH. Los valores ya guardados en los contactos se mantienen.

También puedes cambiar el type, con las mismas reglas de la creación: al pasar a select/multiselect hacen falta las options (si el campo ya las tenía, se mantienen), al pasar a ai hace falta ai_prompt y el campo deja de ser obligatorio.

Respuestas: 200 con el campo y la lista changed de los ajustes modificados — 404 si el campo no es de tu cuenta — 409 si el nuevo nombre ya lo usa otro campo — 422 si un dato no es válido.

Errores comunes: 401 si la clave API falta o es incorrecta — 403 si el plan ha caducado o no incluye el acceso a la API — 429 si haces demasiadas solicitudes en poco tiempo o si hay otro cambio en curso en los campos personalizados de tu cuenta: vuelve a intentarlo tras unos segundos.

Parámetros

9 · 2 obligatorios

apikey obligatorio

Tu API Key (también sirve la cabecera X-API-Key).

id obligatorio

ID del campo (entero, en la ruta). Usa GET /api/contact-fields para encontrarlo.

name opcional

Nuevo nombre (único en tu cuenta).

type opcional

Tipo del campo: input, textarea, number, date, select, multiselect, boolean, url, phone, email o ai.

options opcional

La lista completa de las nuevas opciones (sustituye la actual).

ai_prompt opcional

Nuevo prompt (campos ai).

show_in_list opcional

true para mostrarlo como columna en la lista de contactos, false para quitarlo. Si no lo envías, se queda como está.

visible_to_ai opcional

true si el asistente de IA puede leer su valor, false si no. Si no lo envías, se queda como está.

is_required opcional

true para hacerlo obligatorio en el formulario del contacto, false para quitarlo. Si no lo envías, se queda como está. No admitido para los campos ai.

¿Necesitas ayuda con la integración? info@sendapp.live

curl -X PATCH 'https://app.sendapp.ai/api/contact-fields/13' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "options": ["S", "M", "L", "XL"], "show_in_list": true }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contact-fields/13'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['options' => ['S', 'M', 'L', 'XL'], 'show_in_list' => true]), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields/13', { method: 'PATCH', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ options: ['S', 'M', 'L', 'XL'], show_in_list: true }) }); console.log(await res.json());

{ "status": "success", "message": "Field updated.", "changed": ["options", "show_in_list"], "field": { "id": 13, "name": "Size", "type": "select", "options": ["S", "M", "L", "XL"], "show_in_list": true, "...": "..." } }