Tiendanube - Get Customers

Description

This module allows querying the customer base of a Tiendanube store. It can get a specific customer by ID or list customers with search and date filters.

Configuration

Required Credentials

• Store ID: Your store ID
• Access Token: OAuth2 access token

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Tiendanube credentials
customer_id	string	No	Specific customer ID
q	string	No	Search by name, email, or phone
created_at_min	string	No	Minimum creation date
created_at_max	string	No	Maximum creation date
updated_at_min	string	No	Minimum update date
updated_at_max	string	No	Maximum update date
per_page	number	No	Results per page (default: 50)
page	number	No	Page number (default: 1)

Output

{
  "success": true,
  "customers": [...],
  "count": 50,
  "page": 1,
  "per_page": 50,
  "message": "50 customers retrieved"
}

Customer Fields

• id: Customer ID
• name: Full name
• email: Email
• phone: Phone
• identification: Identity document (DNI/CUIT/CPF)
• note: Internal note
• default_address: Main address
• billing_address: Billing address
• accepts_marketing: Accepts marketing
• total_spent: Total spent
• orders_count: Number of orders
• created_at: Creation date

Usage Example

Get customer by ID

{
  "customer_id": "12345"
}

Search by email

{
  "q": "cliente@email.com"
}

Last month’s customers

{
  "created_at_min": "2024-01-01",
  "created_at_max": "2024-01-31"
}

API Used

• Endpoint: GET /v1/{store_id}/customers
• Documentation: Tiendanube Customers API

Notes

• The q parameter searches in name, email, and phone
• Customers include saved address information
• total_spent is the customer’s total purchase amount
• orders_count is the number of orders placed

Related Nodes

• TiendanubeCreateCustomer - Create a new customer
• TiendanubeUpdateCustomer - Update customer data
• TiendanubeGetOrders - Get customer orders