---
updatedAt: 2026-06-02T19:52:07.000Z
---

# Create a Customer

Create a new customer record in the connected platform. This endpoint is used to register customers programmatically, enabling use cases such as migrating customer bases between platforms, syncing CRM contacts to stores, and automating account creation workflows. Required fields typically include email and name, though additional fields like phone and address may be required depending on the platform.

> **Note:** Some platforms do not allow duplicate email addresses. Refer to the platform-specific endpoint for validation rules.

## Available platforms

This endpoint is supported by **19 platforms**. Click on each platform to see its specific required fields and validation rules.

[Allegro](https://docs.ecartapi.com/reference/create_customer_allegro) · [BigCommerce](https://docs.ecartapi.com/reference/create_customer_bigcommerce) · [Ecwid](https://docs.ecartapi.com/reference/create_customer_ecwid) · [Jumpseller](https://docs.ecartapi.com/reference/create_customer_jumpseller) · [Kometia](https://docs.ecartapi.com/reference/create_customer_kometia) · [Loja](https://docs.ecartapi.com/reference/create_customer_loja) · [Magento 2](https://docs.ecartapi.com/reference/create_customer_magento2) · [Multivende](https://docs.ecartapi.com/reference/create_customer_multivende) · [Nopcommerce](https://docs.ecartapi.com/reference/create_customer_nopcommerce) · [PrestaShop](https://docs.ecartapi.com/reference/create_customer_prestashop) · [QuickBooks](https://docs.ecartapi.com/reference/create_customer_quickbooks) · [Salesforce Enterprise](https://docs.ecartapi.com/reference/create_customer_salesforce_enterprise) · [Shopify](https://docs.ecartapi.com/reference/create_customer_shopify) · [Tienda Nube](https://docs.ecartapi.com/reference/create_customer_tiendanube) · [Tiny](https://docs.ecartapi.com/reference/create_customer_tiny) · [Vend HQ](https://docs.ecartapi.com/reference/create_customer_vendhq) · [WooCommerce](https://docs.ecartapi.com/reference/create_customer_woocommerce) · [Yampi](https://docs.ecartapi.com/reference/create_customer_yampi) · [Zoho Inventory](https://docs.ecartapi.com/reference/create_customer_zoho_inventory)

> **Duplicate email handling varies by platform.** Most platforms enforce email uniqueness. See the platform-specific endpoint for validation rules and required fields.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "EcartAPI",
    "version": "1.0.0",
    "description": "Unified API reference for all EcartAPI resources. EcartAPI connects 50+ e-commerce platforms through a single, consistent API."
  },
  "servers": [
    {
      "url": "https://api.ecartapi.com/api/v2"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Customers",
      "description": "Manage customer records and contact information across supported platforms."
    }
  ],
  "paths": {
    "/customers": {
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Create a Customer",
        "operationId": "create_customer",
        "description": "Create a new customer record in the connected platform. This endpoint is used to register customers programmatically, enabling use cases such as migrating customer bases between platforms, syncing CRM contacts to stores, and automating account creation workflows. Required fields typically include email and name, though additional fields like phone and address may be required depending on the platform.\n\n> **Note:** Some platforms do not allow duplicate email addresses. Refer to the platform-specific endpoint for validation rules.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Customer data to create. Required fields vary by platform.",
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "Customer email address. Typically required and must be unique within the platform."
                  },
                  "firstName": {
                    "type": "string",
                    "description": "Customer first name."
                  },
                  "lastName": {
                    "type": "string",
                    "description": "Customer last name."
                  },
                  "phone": {
                    "type": "string",
                    "description": "Customer phone number. May be required on some platforms."
                  },
                  "acceptsMarketing": {
                    "type": "boolean",
                    "description": "Whether the customer has opted in to marketing communications. Defaults to false if omitted."
                  },
                  "addresses": {
                    "type": "array",
                    "description": "List of addresses to save to the customer profile at creation. Optional.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "address1": {
                          "type": "string",
                          "description": "Primary street address."
                        },
                        "address2": {
                          "type": "string",
                          "description": "Secondary address line (apartment, suite, etc.). Optional."
                        },
                        "city": {
                          "type": "string"
                        },
                        "province": {
                          "type": "string",
                          "description": "State or province."
                        },
                        "country": {
                          "type": "string",
                          "description": "Country name or ISO 3166-1 alpha-2 code."
                        },
                        "zip": {
                          "type": "string",
                          "description": "Postal or ZIP code."
                        },
                        "isDefault": {
                          "type": "boolean",
                          "description": "Set to true to mark this as the customer's default address."
                        }
                      }
                    }
                  },
                  "tags": {
                    "type": "string",
                    "description": "Comma-separated list of tags to assign to the customer profile. Supported on select platforms."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "customer": {
                      "$ref": "#/components/schemas/Customer"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "Customer": {
        "type": "object",
        "description": "EcartAPI unified customer schema. Represents a store customer profile. Field availability varies by platform.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique customer identifier in the connected platform."
          },
          "email": {
            "type": "string",
            "description": "Customer email address."
          },
          "firstName": {
            "type": "string",
            "description": "Customer first name. May be null."
          },
          "lastName": {
            "type": "string",
            "description": "Customer last name. May be null."
          },
          "phone": {
            "type": "string",
            "description": "Customer phone number. May be null."
          },
          "totalOrders": {
            "type": "integer",
            "description": "Total number of orders placed by this customer. May be null."
          },
          "totalSpent": {
            "type": "number",
            "description": "Cumulative order value for this customer. May be null."
          },
          "acceptsMarketing": {
            "type": "boolean",
            "description": "Whether the customer has opted in to marketing communications. May be null."
          },
          "addresses": {
            "type": "array",
            "description": "List of saved addresses for this customer. May be empty if no addresses are stored.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Unique address identifier."
                },
                "firstName": {
                  "type": "string",
                  "description": "First name for this address. May differ from the customer name."
                },
                "lastName": {
                  "type": "string",
                  "description": "Last name for this address."
                },
                "company": {
                  "type": "string",
                  "description": "Company name. May be null."
                },
                "address1": {
                  "type": "string",
                  "description": "Primary street address."
                },
                "address2": {
                  "type": "string",
                  "description": "Secondary address line (apartment, suite, etc.). May be null."
                },
                "city": {
                  "type": "string",
                  "description": "City."
                },
                "province": {
                  "type": "string",
                  "description": "State or province. May be null."
                },
                "country": {
                  "type": "string",
                  "description": "Country name or ISO code."
                },
                "zip": {
                  "type": "string",
                  "description": "Postal or ZIP code."
                },
                "phone": {
                  "type": "string",
                  "description": "Contact phone for this address. May be null."
                },
                "isDefault": {
                  "type": "boolean",
                  "description": "Whether this is the customer's default address."
                }
              }
            }
          },
          "dates": {
            "type": "object",
            "properties": {
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "ISO 8601 timestamp when the customer account was created."
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "ISO 8601 timestamp of the last profile update. May be null."
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```