Skip to main content

Data tab

Before building flows, define the data the campaign works with. The Data tab defines the fields available to the campaign — on the customer profile and on each participant. Fields defined here are used everywhere: imported from CSV files or the API, checked in flow conditions, shown in participant details, and passed to communication actions.

Data tab with the fields table and Import / Required checkboxes

Every field has a Level:

  • Customer Profile — fields that describe the customer, such as Email and Phone. Their values are stored on the customer profile: they appear in 360 View and can be reused by other campaigns. Import and Required are still set per campaign.
  • Participant — fields that exist only inside this campaign, such as a loan amount or a due date. Use these for campaign-specific data.

A new campaign starts with the predefined system Customer Profile fields — External ID, Email, Phone, Telegram ID, Telegram Username, WhatsApp ID, Web ID, and Full Name — with Import enabled and Required disabled.

Fields table​

ColumnMeaning
TitleThe display name users see in the portal.
NameTechnical name of the field — see Name and Title.
DescriptionOptional free text.
TypeData type — see Field types.
LevelCustomer Profile or Participant.
ImportWhether this field can be imported from a file. Only checked fields are read from CSV uploads.
RequiredWhether this field is required. Rows missing a required field fail during upload.
  • Drag the handle at the left of a row to reorder fields. The order is used in the participant details view.
  • Unchecking Import automatically unchecks Required — a field cannot be required if it is not importable.
  • Rows with a lock icon are system fields: System field — cannot be edited or deleted.

Name and Title​

Title is the display name. Name is the machine key:

  • CSV column headers are matched against Name (the match is case-insensitive).
  • In API uploads, the keys in each participant's attributes object are field Name values.
  • Flow conditions and actions reference fields by Name.

Besides CSV uploads, participants can be added with the public API: POST /private/campaigns_v2/{campaign_id}/participants is a synchronous endpoint for enrolling batches of participants from your backend or CRM. See Bulk Add Flow Participants in the API reference.

Field types​

TypeExampleValidation
stringGoldLeading and trailing spaces are removed.
integer42Must be a whole number.
numeric19.99Must be a number.
booleantrueAccepts true/false, 1/0, and yes/no.
date2026-07-05ISO format YYYY-MM-DD.
datetime2026-07-05T14:30:00+02:00ISO 8601. The timezone is optional — a value without one gets the participant's timezone, then the tenant timezone, then UTC.
enumerationbronzeMust match one of the allowed values defined when the field is added.
emailanna@example.comTrimmed, lowercased, and validated against a standard email pattern.
phone+1 (415) 555-0100All non-digit characters ("+", spaces, parentheses) are removed; the value must contain at least one digit. The example is stored as 14155550100.

The type controls which operators a Field Check condition offers and how uploaded values are validated.

Add a field​

  1. Click Manage fields.
  2. In the Manage fields dialog, click Add field.
  3. Fill in Title and Name (both required), optionally a Description, and pick a Type. Fields created here have the Participant level. If you leave Name empty, it's generated from Title: lowercased, spaces replaced with underscores, other special characters removed.
  4. Save the new row and close the dialog. The field appears in the table on the Data tab.

Change or delete a field​

After a field is created, its Name, Type, and Level can't be changed — you can edit the Title and Description. Keep this in mind when you plan the fields:

  • System fields (lock icon) can't be edited or deleted.
  • A custom field can't be deleted while any campaign uses it — the error message lists those campaigns. Remove the field from them first.
  • Deleting a field also removes its stored values from customer profiles and participants.

Best practices​

  • Use Participant fields for campaign-specific data; reuse the Customer Profile fields for data that describes the customer.
  • Settle the field types before you upload data — a type can't be changed after the field is created, and it decides how uploaded values are validated and which comparisons are available in conditions.
  • Keep Name values stable once flows and CSV files reference them.
  • Workflow — use fields in conditions and actions
  • Uploads — import data into these fields
  • Participants — review everyone in the campaign
  • 360 View — the customer profiles behind Customer Profile fields

Was this article helpful?