Customers Mutations

CreateCustomer

Creates a new customer record.

Parameters:

Parameter	Type	Description
input	CustomerInput!	All customer data.

Example Query:

GraphQL

mutation CreateCustomer($input: CustomerInput!) {
  CreateCustomer(input: $input) {
    id
    label
    email
    active
  }
}

---

UpdateCustomer

Updates an existing customer record.

Parameters:

Parameter	Type	Description
id	Int!	ID of the customer.
input	CustomerInput!	Updated fields.

---

DeleteCustomer

Deletes a single customer.

Parameters:

Parameter	Type	Description
id	ID!	Customer ID.

---

DeleteCustomers

Deletes multiple customers.

Parameters:

Parameter	Type	Description
ids	[ID!]!	List of customer IDs.

---

DisableCustomer

Deactivates a single customer (hidden from active lists).

Parameters:

Parameter	Type	Description
id	ID!	Customer ID.

---

DisableCustomers

Deactivates multiple customers.

Parameters:

Parameter	Type	Description
ids	[ID!]!	List of customer IDs.

---

EnableCustomer

Re-activates a single customer.

Parameters:

Parameter	Type	Description
id	ID!	Customer ID.

---

EnableCustomers

Re-activates multiple customers.

Parameters:

Parameter	Type	Description
ids	[ID!]!	List of customer IDs.

---

DuplicateCustomer

Creates a copy of an existing customer.

---

GenerateCustomerNumber

Generates the next available sequence number for a new customer.

---

CreateCustomerAddresses

Adds one or several addresses to a customer.

Parameter	Type	Description
input	[AddressInput]!	List of addresses to add.

---

UpdateCustomerAddress / DeleteCustomerAddress

Manage specific addresses linked to a customer.

---

Input Data Types

CustomerInput

Field	Type	Description
id	Int	ID for updates.
label	String	Customer name or company name.
first_name	String	Primary contact first name.
last_name	String	Primary contact last name.
email	String	Primary email address.
addresses	CustomerAddressInput	Initial addresses list.
customer_number	String	Reference number.
customer_type	CustomerType	Individual or Company.
website	String	Website URL.
phone	String	Phone number.
status	String	Lifecycle status.
notes	String	Public notes.
private_message	String	Private internal notes.
currency	CurrencyInput	Preferred currency.
location_id	Int	Primary location ID.
location	LocationInput	Location details.
price_level_id	Int	Price level ID.
price_level	PriceLevelInput	Price level data.
account_representative_id	Int	Rep ID.
account_representative	AccountRepresentativeInput	Rep data.
tax_number	String	VAT/Tax ID.
company_registration_number	String	Registration ID.
payment_information_id	Int	Payment details link ID.
payment_information	PaymentInformationInput	Payment details.
discount	Float	Default discount %.
minimum_order_amount	Float	Minimum order value.
term_of_payment_days	Int	Payment term days.
term_of_payment_type	TermModel	Term calculation logic.
credit_limit	Float	Maximum allowed credit.
location_id	Int	Default location ID.
location	LocationInput	Default location data.
language	String	Preferred language code.
tax_type	TaxType	"exclusive" or "inclusive".
tax_codes	[TaxCodeInput]	List of applied tax codes.
customer_tags	[CustomerTagInput]	Segmentation labels.
files	[FileInput]	Attachments.
order_template	PdfTemplateInput	Default Order PDF design.
shipping_order_template	PdfTemplateInput	Default Shipping PDF design.
invoice_template	PdfTemplateInput	Default Invoice PDF design.
product_return_template	PdfTemplateInput	Default Return PDF design.
credit_note_template	PdfTemplateInput	Default Credit Note PDF design.
refund_template	PdfTemplateInput	Default Refund PDF design.
picking_list_template	PdfTemplateInput	Default Picking PDF design.
estimate_template	PdfTemplateInput	Default Estimate PDF design.
custom_fields	[EntityCustomFieldInput]	Custom fields for this entity.

---

CustomerAddressInput

Field	Type	Description
data	[AddressInput]	Array of initial addresses.

---

Enums

CustomerType

Value
company
individual

TermModel

Value	Description
net	Due after X days from document date.
eom	Due at End of Month after X days.
eom_first	Due at End of Month (first day focus).

TaxType

Value	Description
exclusive	Tax calculated on top of the net price.
inclusive	Tax included in the displayed price.