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.

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?