---
title: "Save customers"
method: POST
path: "/v6/customers"
tags: ["Customers"]
---

# Save customers

`POST /v6/customers`

Save new (or update existing) customers

## Request body

- MultiParamCustomerPostDto
  - `data` CustomerPostDto[], required
    - `id` string — Id of the customer, required when updating an existing customer
    - `name` string, required — Name of the customer
    - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED' — Status of the customer
    - `additionalContactName` string — Name of an additional contact for this customer
    - `businessName` string — Business name of the customer
    - `email` string — Email address of the customer
    - `ccEmails` string[]
    - `bccEmails` string[]
    - `invoiceSettings` CustomerInvoiceSettingsPostDto — Invoice display settings for this customer
      - `invoicePrefix` string — Prefix used for invoice numbers for this customer
      - `showAdditionalContactName` boolean — Whether to show the additional contact name on invoices
      - `showBusinessName` boolean — Whether to show the business name on invoices
      - `showName` boolean — Whether to show the customer name on invoices
      - `showEmail` boolean — Whether to show the customer email on invoices
      - `showAddress` boolean — Whether to show the customer address on invoices
      - `showPhoneWork` boolean — Whether to show the work phone number on invoices
    - `address` AddressPostDto — Address of the vendor
      - `state` string — State/Province of the address
      - `city` string — City of the address
      - `zip` string — Zip/Postal code of the address
      - `phoneWork` string — The US/CA phone number in E.164 format (e.g., +14155551234)
      - `address1` string — First line of the address
      - `address2` string — Second line of the address
    - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
      - `empty` boolean
      - `array` boolean
      - `null` boolean
      - `object` boolean
      - `float` boolean
      - `string` boolean
      - `number` boolean
      - `missingNode` boolean
      - `valueNode` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `pojo` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `double` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `boolean` boolean
      - `binary` boolean
      - `container` boolean
      - `embeddedValue` boolean

## Response `200`

Success

- ResponseListMultiResponseCustomerGetDto
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` MultiResponseCustomerGetDto[] — The data generated by the action performed.
    - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
    - `statusCode` 200 | 400 | 401 | 403 | 404 | 500 — The HTTP status code for the action performed.
    - `data` CustomerGetDto — The data generated by the action performed.
      - `id` string, required — Id of the customer
      - `name` string, required — Name of the customer
      - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the customer
      - `additionalContactName` string, nullable, required — Name of an additional contact for this customer
      - `businessName` string, nullable, required — Business name of the customer
      - `email` string, nullable, required — Email address of the customer
      - `ccEmails` string[], required — CC email addresses for invoices sent to this customer
      - `bccEmails` string[], required — BCC email addresses for invoices sent to this customer
      - `invoiceSettings` CustomerInvoiceSettingsGetDto, required — Invoice display settings for this customer
        - `invoicePrefix` string, nullable, required — Prefix used for invoice numbers for this customer
        - `showAdditionalContactName` boolean, required — Whether to show the additional contact name on invoices
        - `showBusinessName` boolean, required — Whether to show the business name on invoices
        - `showName` boolean, required — Whether to show the customer name on invoices
        - `showEmail` boolean, required — Whether to show the customer email on invoices
        - `showAddress` boolean, required — Whether to show the customer address on invoices
        - `showPhoneWork` boolean, required — Whether to show the work phone number on invoices
      - `address` AddressGetDto, nullable, required — Address of the vendor
        - `countryCode` 'USA' | 'CAN' | 'GBR' — Country Code of the address
        - `state` string — State/Province of the address
        - `city` string — City of the address
        - `zip` string — Zip/Postal code of the address
        - `phoneWork` string — The phone number
        - `address1` string — First line of the address
        - `address2` string — Second line of the address
      - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
        - `empty` boolean
        - `array` boolean
        - `null` boolean
        - `object` boolean
        - `float` boolean
        - `string` boolean
        - `number` boolean
        - `missingNode` boolean
        - `valueNode` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `binary` boolean
        - `container` boolean
        - `embeddedValue` boolean
    - `error` ErrorItem[]
      - `type` 'UNKNOWN_ERROR' | 'INVALID_TOKEN' | 'EXPIRED_TOKEN' | 'FORBIDDEN' | 'BAD_REQUEST' | 'JSON_ERROR' | 'DUPLICATE' | 'REQUIRED' | 'INVALID_VALUE' | 'NOT_MODIFIABLE' | 'INVALID_FORMAT' | 'NOT_FOUND' — The type of the error. Safe for programmatic use.
      - `message` string — A human-readable message providing more details about the error. Safe for displaying to a user.
      - `param` string — If the error is parameter-specific, the parameter related to the error. This can be used to display a message near the correct form field.
  - `error` ErrorItem[]
    - `type` 'UNKNOWN_ERROR' | 'INVALID_TOKEN' | 'EXPIRED_TOKEN' | 'FORBIDDEN' | 'BAD_REQUEST' | 'JSON_ERROR' | 'DUPLICATE' | 'REQUIRED' | 'INVALID_VALUE' | 'NOT_MODIFIABLE' | 'INVALID_FORMAT' | 'NOT_FOUND' — The type of the error. Safe for programmatic use.
    - `message` string — A human-readable message providing more details about the error. Safe for displaying to a user.
    - `param` string — If the error is parameter-specific, the parameter related to the error. This can be used to display a message near the correct form field.

## Other responses

- `207` — Some customers failed to save. See response body for error details.
- `400` — All customers failed to save.
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

[API](https://skmtc.net/tight/apis/tight-api.md) · [All operations](https://skmtc.net/tight/apis/tight-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tight/tight-api/revisions/e9f0790a89af/schema)