Skip to main content

​
Customer Management

The Customers API lets you create records, list with filters, and retrieve by ID. Customer tags power funnel segmentation together with device and geo enrichment.

​
Create a customer

const customer = await tagada.customers.create({
  storeId: 'store_...',
  email: 'jane@example.com',
  firstName: 'Jane',
  lastName: 'Doe',
});

​
List with filters

const { data: customers, total, hasMore } = await tagada.customers.list({
  filters: {
    storeIds: ['store_...'],
    email: 'jane@example.com',
    tags: ['vip'],
  },
  pageSize: 25,
});
Supported filters include storeIds, firstName, lastName, email, paymentInstrumentCardLast4, and tags. Use page, pageSize, and sortBy for pagination and ordering.

​
Retrieve one customer

const customer = await tagada.customers.retrieve('cus_...');

​
Tags and funnel conditions

Funnel edges can branch on customer tags, geo/device signals, and related predicates. Typical tag- and profile-driven conditions include:
ConditionPurpose
customer.hasTagExact tag match (e.g. vip)
customer.hasTagPrefixTags starting with a prefix (e.g. plan tiers)
customer.hasAnyTagComma-separated list — match if any present
customer.hasAllTagsComma-separated list — match if all present
customer.fromCountryCountry code
customer.fromContinentContinent code
customer.fromEUEU residency heuristic
customer.withLocaleBrowser/locale string
customer.withBrowserBrowser family
customer.onMobileMobile device
customer.fromUtmSourceUTM / source attribution
customer.isBotAutomated traffic
customer.isChromeFamilyChromium-based browser
customer.isStandalonePWAInstalled PWA
customer.isAppleSiliconApple Silicon device
Express conditions in funnel edge conditions.when objects the same way as in the Upsell & downsell funnel tutorial (e.g. { when: { 'customer.hasTag': { tag: 'vip' } } }).

​
Auto-enriched tags

During funnel/checkout flows, TagadaPay can merge device and geo tags (and UTM-style tags from the device) onto the customer, for example:
Tag patternExample
geo_country:<code>geo_country:US
geo_continent:<code>geo_continent:NA
geo_is_eu:<bool>geo_is_eu:true
device_type:<type>device_type:mobile
browser:<name>browser:chrome
utm_source:<value>utm_source:facebook
Exact sets depend on available device data and enrichment settings. Custom query parameters can also become tags when wildcard mapping is enabled on your project.

​
SDK methods reference

MethodDescription
tagada.customers.create(params)Create a customer (storeId, email, optional names)
tagada.customers.list(params?)POST /customers/list with filters and pagination
tagada.customers.retrieve(customerId)GET a single customer

​
Next steps

Checkout sessions

Pre-loaded carts and customerTags on session links

Upsell & downsell funnel

Example conditions using tags and order context

Block rules

Block risky traffic and instruments at the account level

Merchant quick start

Full SDK walkthrough from processor to checkout