Lista de campos personalizados

GET https://app.sendapp.ai/api/contact-fields

Devuelve los campos personalizados de los contactos de tu cuenta (página Campos personalizados), en el orden en que los ves en la página. Usa el name de un campo para escribir su valor en un contacto con custom_fields en Actualizar contacto.

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: vuelve a intentarlo tras unos segundos.

Parámetros

1 · 1 obligatorios

apikey obligatorio

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

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

Solicitud

curl 'https://app.sendapp.ai/api/contact-fields' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contact-fields');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Respuesta

{
  "status": "success",
  "total": 2,
  "types": ["input", "textarea", "number", "date", "select", "multiselect", "boolean", "url", "phone", "email", "ai"],
  "fields": [
    {
      "id": 12,
      "name": "City",
      "type": "input",
      "options": null,
      "ai_prompt": null,
      "show_in_list": true,
      "visible_to_ai": true,
      "is_required": false,
      "sort_order": 0,
      "created_at": "2026-10-29 10:00:00",
      "updated_at": "2026-10-29 10:00:00"
    },
    {
      "id": 13,
      "name": "Size",
      "type": "select",
      "options": ["S", "M", "L"],
      "ai_prompt": null,
      "show_in_list": false,
      "visible_to_ai": true,
      "is_required": true,
      "sort_order": 1,
      "created_at": "2026-10-29 10:05:00",
      "updated_at": "2026-10-29 10:05:00"
    }
  ]
}

{
  "status": "error",
  "message": "Your current plan does not include API access."
}