Skip to main content

Search Customers

Search for customers based on a query.

NOTE: Newly created customers may take a minute to show up in a search result due to API limitations.

Parameters

ParameterDescription
FieldsShow only certain fields, specified by a comma-separated list of field names.
LimitThe maximum number of results to show.
(default: 50, maximum: 250).
QueryText to search for in the shop's customer data.

Example: email:*@mail.example.com

Note: Supported queries: accepts_marketing, activation_date, address1, address2, city, company, country, customer_date, customer_first_name, customer_id, customer_last_name, customer_tag, email, email_marketing_state, first_name, first_order_date, id, last_abandoned_order_date, last_name, multipass_identifier, orders_count, order_date, phone, province, shop_id, state, tag, total_spent, updated_at, verified_email, product_subscriber_status. All other queries returns all customers.
Return All PagesAutomatically fetch all resources, page by page.
Sort OrderSet the field and direction by which to order results.
(default: last_order_date DESC).

Workflow Library Example

Search Customers with Shopify and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop