Campos

Los campos son las definiciones de columnas para contactos y empresas. Utilice estos endpoints para descubrir los campos disponibles, tanto integrados como personalizados, antes de importar o actualizar registros.

---

Listar campos de contactos

GET /fields

Devuelve todas las definiciones de campos de contactos, incluidos los campos base y cualquier campo personalizado. Pase list_id para incluir los campos personalizados específicos de una lista.

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
list_id	integer	—	Incluir campos personalizados específicos de esta lista

Ejemplo

cURL

curl "https://be.graph8.com/api/v1/fields" \
  -H "Authorization: Bearer $API_KEY"

Python

response = requests.get(
    f"{BASE_URL}/fields",
    headers=HEADERS
)
fields = response.json()

TypeScript

const response = await fetch(`${BASE_URL}/fields`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const fields = await response.json();

Respuesta

{
  "data": [
    {
      "id": 1,
      "title": "First Name",
      "name": "CONTACT_FIRST_NAME",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 2,
      "title": "Work Email",
      "name": "CONTACT_WORK_EMAIL",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 150,
      "title": "Lead Score",
      "name": "custom_lead_score",
      "data_type": "number",
      "is_global": false
    }
  ]
}

---

Listar campos de empresas

GET /fields/companies

Devuelve todas las definiciones de campos de empresas, incluidos los campos base y cualquier campo personalizado.

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
list_id	integer	—	Incluir campos personalizados específicos de esta lista

Ejemplo

cURL

curl "https://be.graph8.com/api/v1/fields/companies" \
  -H "Authorization: Bearer $API_KEY"

Python

response = requests.get(
    f"{BASE_URL}/fields/companies",
    headers=HEADERS
)
fields = response.json()

TypeScript

const response = await fetch(`${BASE_URL}/fields/companies`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const fields = await response.json();

Respuesta

{
  "data": [
    {
      "id": 1,
      "title": "Company Name",
      "name": "COMPANY_NAME",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 2,
      "title": "Domain",
      "name": "COMPANY_DOMAIN",
      "data_type": "text",
      "is_global": true
    }
  ]
}