Standardfelder & eigene Felder
Felder allgemein
Die Daten einer jeden Person werden in sogenannten Feldern gespeichert. Sie sind vergleichbar mit den Spalten einer Excel-Tabelle. Welche Felder zur Verfügung stehen, ist abhängig von der zugehörigen Liste, in der die Person sich befindet.
Es gibt zwei verschiedene Arten von Feldern:
Standardfelder
Je nach Listentyp (Mitglieder, Events, Kontakte) sind unterschiedliche Standardfelder verfügbar. Die vollständige Übersicht kann hier eingesehen werden.
Um Daten für eine Person in Standardfeldern zu hinterlegen, wird dafür der feste Identifier (z.B. email) verwendet.
Beispiel für E-Mail-Feld
{
"email": "info@campflow.de"
}
Eigene Felder
Für jede Liste können zusätzlich “eigene Felder” angelegt werden. Dies ist sowohl über die UI im Tool als auch über die API möglich.
Jedes eigene Feld hat eine eindeutige id, die mit col_ beginnt. Die id wird als Identifier verwendet, um Daten in Personen zu hinterlegen.
Beispiel für eigenes Feld “Lieblingsfarbe”:
{
"col_3xB563caEa6CE4RuDKbv": "Blau"
}
Wenn eigene Felder über die API angelegt werden, kann für diese optional eine external_id festgelegt werden. Ist external_id festgelegt, kann der Inhalt des Feldes alternativ zur id auch mit custom_{external_id} aktualisiert werden.
Beispiel für eigenes Feld “Lieblingsfarbe” mit external_id: "lieblingsfarbe"
{
"custom_lieblingsfarbe": "Blau"
}
Beim Ausgeben einer Person wird jedoch weiterhin nur die id als Key verwendet.