Custom fields
Attach your own fields to a customer — CSM owner, onboarding stage, seat count, plan tier, anything your product knows that a billing API cannot expose.
How fields arrive
Send them in the custom_fields object on
POST /api/customers/identify (or through either official SDK):
{
"shop": "store.myshopify.com",
"email": "[email protected]",
"custom_fields": { "selectedPlan": "Pro", "seats": 5 }
}
A field auto-registers the first time it is seen — there is nothing to define up front. Values land on the customer and render in the Custom fields panel of its Customer view.
What you can do with them
- Segment on them. Custom fields are first-class attributes in the segment builder, so "Pro plan with more than 3 seats" is a saved view rather than a spreadsheet.
- Merge them into email. A field is available as a merge tag in campaign and flow templates.
- Branch a flow on them. Flow conditions read custom fields the same way they read plan or country.
Why it matters
Custom fields let CoreX model your business rather than only what the connector reports — which is what makes segments, flows and outreach specific enough to act on.