Tiendanube - Create Customer

Description

This module allows registering new customers in a Tiendanube store with their personal data, marketing preferences, and optionally a default address.

Configuration

Required Credentials

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

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Tiendanube credentials
email	string	Yes	Customer email
name	string	Yes	Full name
phone	string	No	Phone
identification	string	No	ID document (DNI/CUIT/CPF)
note	string	No	Internal note
accepts_marketing	boolean	No	Accepts marketing
address	string	No	Street
number	string	No	Number
floor	string	No	Floor/Apartment
city	string	No	City
province	string	No	Province/State
zipcode	string	No	Postal code
country	string	No	Country code (AR, BR, MX, etc.)

Output

{
  "success": true,
  "customer": {...},
  "customer_id": 12345,
  "email": "cliente@email.com",
  "message": "Customer 12345 created successfully"
}

Usage Example

Create basic customer

{
  "email": "juan@email.com",
  "name": "Juan Perez"
}

Create customer with phone and marketing

{
  "email": "maria@email.com",
  "name": "Maria Garcia",
  "phone": "+54 11 1234-5678",
  "identification": "12345678",
  "accepts_marketing": true
}

Create customer with address

{
  "email": "carlos@email.com",
  "name": "Carlos Lopez",
  "phone": "+54 11 9876-5432",
  "address": "Av. Corrientes",
  "number": "1234",
  "floor": "5to B",
  "city": "Buenos Aires",
  "province": "Buenos Aires",
  "zipcode": "1043",
  "country": "AR"
}

API Used

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

Notes

• The email must be unique in the store
• Country codes are ISO 3166-1 alpha-2 (AR, BR, MX, CL, CO, etc.)
• The identification field stores the local identity document
• If accepts_marketing: true, the customer will receive promotional emails

Related Nodes

• TiendanubeGetCustomers - Get existing customers
• TiendanubeUpdateCustomer - Update customer data
• TiendanubeGetOrders - Get customer orders