Lista de campos personalizados

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

Devolve os campos personalizados dos contactos da tua conta (página Campos personalizados), pela ordem em que os vês na página. Usa o name de um campo para escrever o seu valor num contacto com custom_fields em Atualizar contacto.

Tipos disponíveis: input, textarea, number, date, select, multiselect, boolean, url, phone, email, ai. options só tem valor para select e multiselect, ai_prompt só para ai.

Erros comuns: 401 se a chave API falta ou está errada — 403 se o plano expirou ou não inclui o acesso à API — 429 se fizeres demasiados pedidos em pouco tempo: tenta novamente após alguns segundos.

Parâmetros

1 · 1 obrigatórios

apikey obrigatório

A sua API Key (o cabeçalho X-API-Key também funciona).

Precisa de ajuda com a integração? info@sendapp.live

Pedido

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());

Resposta

{
  "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."
}