list_store_customers
List customers from a connected e-commerce store with order counts, total spend, and opt-in status to analyze purchasing behavior and identify high-value customers.
Instructions
List customers from a connected e-commerce store with order counts, total spend, and opt-in status.
Use to analyze customer purchasing behavior or identify high-value customers. Requires an active e-commerce integration. Use list_ecommerce_stores to find store IDs. Use list_store_orders for per-order detail instead of customer-level aggregates.
Args: store_id: The e-commerce store ID. Obtain from list_ecommerce_stores. count: Number of customers to return (1-1000, default 20). offset: Pagination offset. Use when total_items exceeds count.
Returns: JSON with total_items and customers array. Each customer: id (string), email_address, first_name, last_name, orders_count (int), total_spent (float, in store currency), opt_in_status (boolean), created_at (ISO 8601).
Example: list_store_customers(store_id="store123", count=50) -> {"total_items": 500, "customers": [{"email_address": "jane@co.com", "orders_count": 5, "total_spent": 299.95, ...}]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| offset | No | ||
| account | No | ||
| store_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |