Shopify - Get Customers

Description

This module allows querying customers from your Shopify store, either a specific customer by ID or a list with search by email, name, or other criteria.

Configuration

Field	Type	Required	Description
credentials_id	string	Yes	Shopify credentials ID
customer_id	number	No	Specific customer ID
query	string	No	Search by email, name, etc.
created_at_min	string	No	Created since (ISO 8601)
created_at_max	string	No	Created until (ISO 8601)
updated_at_min	string	No	Updated since (ISO 8601)
updated_at_max	string	No	Updated until (ISO 8601)
limit	number	No	Result limit (max 250)
since_id	number	No	Customers with ID greater than this
fields	string	No	Fields to return

Credentials

This module requires Shopify credentials.

Field	Description
shop_domain	Store domain (my-store.myshopify.com)
access_token	Admin API access token

Query Syntax

Search	Example
By email	email:cliente@ejemplo.com
By first name	first_name:Juan
By last name	last_name:Garcia
By phone	phone:+34600000000
By country	country:Spain
Free text	Juan Garcia (searches all fields)

Output

{
  "success": true,
  "customers": [
    {
      "id": 123456789,
      "email": "cliente@ejemplo.com",
      "first_name": "Juan",
      "last_name": "Garcia",
      "phone": "+34600000000",
      "orders_count": 5,
      "total_spent": "450.00",
      "created_at": "2024-01-15T10:30:00-05:00",
      "addresses": [],
      "tags": "vip, newsletter"
    }
  ],
  "total": 25,
  "filters_applied": {}
}

Usage Example

Get customer by ID

{
  "credentials_id": "shopify_tienda",
  "customer_id": 123456789
}

Search by email

{
  "credentials_id": "shopify_tienda",
  "query": "email:cliente@ejemplo.com"
}

New customers this month

{
  "credentials_id": "shopify_tienda",
  "created_at_min": "2024-01-01T00:00:00Z",
  "limit": 100
}

Notes

• Search by query is case-insensitive
• The maximum limit per request is 250 customers
• For pagination, use since_id with the last customer’s ID

Related Nodes

• ShopifyCreateCustomer - Create new customers
• ShopifyUpdateCustomer - Update an existing customer’s data
• ShopifyGetOrders - Get orders (filterable by customer)