---
updatedAt: 2026-07-10T20:17:06.000Z
agentTools:
  projectIndex: https://developer.crunchtime.com/llms.txt
---

# saveCustomers

Create a new customer account. 
 Update a customer's account details.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "Swagger documentation supporting mobile development of Crunchtime.",
    "version": "3.05",
    "title": "Cruise Platform",
    "termsOfService": "http://springfox.io",
    "contact": {
      "name": "Crunchtime Development Team",
      "url": "http://www.crunchtime.com",
      "email": "apiquestions@crunchtime.com"
    },
    "license": {
      "name": "Apache License Version 2.0",
      "url": "https://github.com/springfox/springfox/blob/master/LICENSE"
    }
  },
  "tags": [
    {
      "name": "Customer Service",
      "description": "The Customer Service can be used to create a “Customer” that is an establishment or outlet to which a Crunchtime Location sells or distributes products and/or produced Recipe items. It may be an outlet within the Location or an entirely external entity, e.g. a “catering” Customer. “Customer” records are required to “issue” items to these entities via “Customer Order” transactions."
    }
  ],
  "paths": {
    "/cruise/customer/v1/saveCustomers": {
      "post": {
        "tags": [
          "Customer Service"
        ],
        "summary": "saveCustomers",
        "description": "Create a new customer account. \n Update a customer's account details.",
        "operationId": "saveCustomerRecordsUsingPOST",
        "parameters": [
          {
            "name": "authenticationtoken",
            "in": "header",
            "description": "Secure token for API authentication.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "password",
            "in": "header",
            "description": "Password for the Crunchtime Application User.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sitename",
            "in": "header",
            "description": "Crunchtime site identifier. (test or production)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "userid",
            "in": "header",
            "description": "User ID for the Crunchtime Application User.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-B3-TraceId",
            "in": "header",
            "description": "Optional trace identifier for troubleshooting.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerDetailsList"
              }
            }
          },
          "description": "customerDetails",
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Validation Error",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectError"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectError"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Authorization",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected Error",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "System under maintenance",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "description": "Timeout",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Using CrunchTime APIs Documentation",
    "url": "https://links.crunchtime.com/SG-UsingCrunchtimeAPIs?pd01=api"
  },
  "servers": [
    {
      "url": "//webservices-test.net-chef.com"
    }
  ],
  "components": {
    "schemas": {
      "ObjectError": {
        "type": "object",
        "properties": {
          "arguments": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "code": {
            "type": "string"
          },
          "codes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "defaultMessage": {
            "type": "string"
          },
          "objectName": {
            "type": "string"
          }
        },
        "title": "ObjectError"
      },
      "CustomerDetailsDtoReq": {
        "type": "object",
        "required": [
          "address1",
          "city",
          "country",
          "customerCode",
          "customerName",
          "locationCode",
          "supplyPricing"
        ],
        "properties": {
          "activeFlag": {
            "type": "string",
            "example": "Y",
            "description": "\"activeFlag\" from Customer"
          },
          "address1": {
            "type": "string",
            "example": "100 Main Street1",
            "description": "\"address1\" from Customer"
          },
          "address2": {
            "type": "string",
            "example": "100 Main Street2",
            "description": "\"address2\" from Customer"
          },
          "city": {
            "type": "string",
            "example": "BOSTON",
            "description": "\"city\" from Customer"
          },
          "country": {
            "type": "string",
            "example": "USA",
            "description": "\"country\" from Customer"
          },
          "customerAccountNumber": {
            "type": "string",
            "example": "860 536-4589 428",
            "description": "\"customerAccountNumber\" from Customer"
          },
          "customerCode": {
            "type": "string",
            "example": "030292",
            "description": "\"customerCode\" from Customer"
          },
          "customerName": {
            "type": "string",
            "example": "Melissa's Vendor",
            "description": "\"customerName\" from Customer"
          },
          "deleteFlag": {
            "type": "string",
            "example": "Y",
            "description": "\"deleteFlag\" from Customer"
          },
          "exportCode": {
            "type": "string",
            "example": "EXP1",
            "description": "\"exportCode\" from Customer"
          },
          "importCode": {
            "type": "string",
            "example": "new_imp_code1",
            "description": "\"importCode\" from Customer"
          },
          "locationCode": {
            "type": "string",
            "example": 123456,
            "description": "\"locationCode\" from Customer"
          },
          "retailPricing": {
            "type": "string",
            "example": "STAN",
            "description": "\"retailPricing\" from Customer"
          },
          "state": {
            "type": "string",
            "example": "IN",
            "description": "\"state\" from Customer"
          },
          "supplyPricing": {
            "type": "string",
            "example": "COST PLUS",
            "description": "\"supplyPricing\" from Customer"
          },
          "zipcode": {
            "type": "string",
            "example": "02114",
            "description": "\"zipcode\" from Customer"
          }
        },
        "title": "CustomerDetailsDtoReq",
        "description": "CustomerDetailsDto description"
      },
      "CustomerDetailsList": {
        "type": "object",
        "required": [
          "locationCode"
        ],
        "properties": {
          "customerDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomerDetailsReq"
            }
          },
          "locationCode": {
            "type": "string",
            "example": "000000",
            "description": "The Code that identifies the Location in Crunchtime."
          }
        },
        "title": "CustomerDetailsList",
        "description": "CustomerDetailsList description"
      },
      "CustomerDetailsReq": {
        "type": "object",
        "properties": {
          "customerDetailDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomerDetailsDtoReq"
            }
          }
        },
        "title": "CustomerDetailsReq",
        "description": "CustomerDetails description"
      }
    }
  }
}
```