BigCommerce - Create Customer

Description

This module allows registering new customers in a BigCommerce store with their personal data and optionally an associated address.

Configuration

Required Credentials

• Store Hash: Unique hash of your BigCommerce store
• Access Token: API V3 access token

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	BigCommerce credentials
email	string	Yes	Customer email
first_name	string	Yes	First name
last_name	string	Yes	Last name
company	string	No	Company
phone	string	No	Phone
customer_group_id	number	No	Customer group ID
address1	string	No	Address line 1
city	string	No	City
state	string	No	State/Province
zip	string	No	Postal code
country_code	string	No	Country code (e.g.: US, ES, MX)

Output

{
  "success": true,
  "customer": {...},
  "customer_id": 789,
  "message": "Customer 789 created successfully"
}

Usage Example

Create basic customer

{
  "email": "nuevo@cliente.com",
  "first_name": "Juan",
  "last_name": "Perez"
}

Create customer with company

{
  "email": "empresa@cliente.com",
  "first_name": "Maria",
  "last_name": "Garcia",
  "company": "Empresa ABC",
  "phone": "+34 600 123 456",
  "customer_group_id": 3
}

Create customer with address

{
  "email": "completo@cliente.com",
  "first_name": "Carlos",
  "last_name": "Lopez",
  "address1": "Calle Principal 123",
  "city": "Madrid",
  "state": "Madrid",
  "zip": "28001",
  "country_code": "ES"
}

API Used

• Endpoint: POST /stores/{store_hash}/v3/customers
• Documentation: BigCommerce Create Customer

Notes

• The V3 API requires sending data as an array of customers
• The email must be unique in the store
• If an address is provided, all address fields are individually optional
• Country codes must be ISO 3166-1 alpha-2 (e.g.: US, ES, MX, AR)
• The customer group must already exist

Related Nodes

• BigcommerceGetCustomers - Get customers
• BigcommerceUpdateCustomer - Update customer
• BigcommerceGetOrders - Get customer orders