Crear campo personalizado
POST
https://app.sendapp.ai/api/contact-fields
Crea un nuevo campo personalizzado para los contactos, con las mismas reglas que la página Campos personalizados. El campo se añade al final de la lista.
Respuestas:
201 Created con el campo creado — 409 si ya existe un campo con el mismo nombre (sin distinguir mayúsculas y minúsculas) — 422 si un dato no es válido (el mensaje enumera los tipos válidos).Tipos disponibles:
input, textarea, number, date, select, multiselect, boolean, url, phone, email, ai. options solo tiene valor para select y multiselect, ai_prompt solo para ai.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
8 · 3 obligatorios
apikey
obligatorio
Tu API Key (también sirve la cabecera
X-API-Key).
name
obligatorio
Nombre del campo, hasta 255 caracteres. Debe ser único en tu cuenta: es el nombre con el que escribes el valor en un contacto.
type
obligatorio
Tipo del campo:
input, textarea, number, date, select, multiselect, boolean, url, phone, email o ai.
options
opcional
Solo para
select y multiselect (obligatorio): array de opciones, de 1 a 50, únicas, cada una de hasta 60 caracteres. También acepta una cadena separada por comas.
ai_prompt
opcional
Solo para
ai (obligatorio): qué debe extraer la IA de las conversaciones, hasta 500 caracteres.
show_in_list
opcional
true para mostrarlo como columna en la lista de contactos (por defecto false).
visible_to_ai
opcional
true si el asistente de IA puede leer su valor (por defecto true).
is_required
opcional
true para hacerlo obligatorio en el formulario del contacto (por defecto false). No se admite en los campos
ai.
¿Necesitas ayuda con la integración? info@sendapp.live