Custom fields

Custom fields let you attach arbitrary metadata to contacts — plan tier, last purchase date, referral source, anything your app tracks about a user.

Registering a field

Open Settings → Organization → Custom fields (or Contacts → Properties in the sidebar). Click Register property and provide:

• Key — programmatic identifier (plan_tier, last_purchase_at). Snake case, letters/numbers/underscore only.
• Type — string, number, boolean, datetime.
• Label — human-readable display name.

Setting values

Three ways to populate:

1. CSV import — include a column with the property key.

2. Web console — edit a contact profile directly.

3. API — batch update for real-time systems:

   curl -X POST https://api.aigeon.ai/public/api/v1/contacts/profile/batch-update-custom-field \
     -H "X-Api-Token: sk_..." \
     -H "Content-Type: application/json" \
     -d '{
       "emails": ["alice@example.com"],
       "updates": { "plan_tier": "pro", "last_purchase_at": "2026-04-20T00:00:00Z" }
     }'
   

Using custom fields

• Personalization — reference any field in templates with {{contact.plan_tier}}.
• Segmentation — every registered field is available in the segment builder.
• Flow branching — split a flow based on a field value to send different emails to different plan tiers.