Import customers, Shopify, WooCommerce, CSV
Three ways to import, Shopify webhook (continuous), CSV upload (manual/scheduled), or REST API for custom CRM sources. Every imported customer is created as private_seed.
Shopify (recommended for e-commerce)
Connect the Shopify integration once, new customers + orders flow into Keepface automatically. Order LTV, country, and product affinity all import alongside. See Connect Shopify.
CSV upload
Use for WooCommerce, Magento, or any list you can export. Customers → Import → Upload CSV. Required columns: email (unique key) + at least one of full_name, phone, country. Optional: lifetime_value, first_order_at, last_order_at, tags. Re-import is idempotent on email, re-uploading the same file updates existing rows, doesn’t duplicate.
API (custom CRM)
POST /api/v2/marketplace/customers/import accepts the same shape as CSV. Auth via the workspace API key in Workspace settings → API tokens.
What’s stored
- Contact (email/phone), used for referral mints, UGC requests, NPS sends
- Order history (if provided), drives VIP tier classification
- Consent state, defaults to unknown; must be granted before marketing outreach