Skip to main content

CustomerUpdateItemInput

A customer update in a bulk operation. Only the provided fields change; follows the same rules as updateCustomer.

input CustomerUpdateItemInput {
  billToCompany: String
  billToEmail: String
  billToName: String
  billToPhone: String
  billToSameAsShipTo: Boolean
  billingAddress: CustomerAddressInput
  contactName: String
  contactTitle: String
  contacts: [CustomerContactUpdateInput!]
  customerType: CustomerTypeEnum
  defaultTemplateId: ID
  defaultView: CustomerViewEnum
  email: String
  freightPayer: FreightPayerEnum
  handle: String
  id: ID!
  legalName: String
  locations: [CustomerLocationUpdateInput!]
  name: String
  notes: String
  parentId: ID
  paymentTerms: String
  phone: String
  preferredContactMethod: PreferredContactMethodEnum
  preferredLanguage: String
  salesChannelId: ID
  shipToCompany: String
  shipToEmail: String
  shipToName: String
  shipToPhone: String
  shippingAccounts: [CustomerShippingAccountInput!]
  shippingAddress: CustomerAddressInput
  startDate: ISO8601Date
  taxExempt: Boolean
  taxId: String
  website: String
}

Fields

`CustomerUpdateItemInput.billToCompany` ● `String` scalar common

Default bill-to company name.

`CustomerUpdateItemInput.billToEmail` ● `String` scalar common

Default bill-to contact email.

`CustomerUpdateItemInput.billToName` ● `String` scalar common

Default bill-to contact name.

`CustomerUpdateItemInput.billToPhone` ● `String` scalar common

Default bill-to contact phone.

`CustomerUpdateItemInput.billToSameAsShipTo` ● `Boolean` scalar common

When true, bill-to contact details mirror ship-to.

`CustomerUpdateItemInput.billingAddress` ● `CustomerAddressInput` input common

Default billing address. Pass null to remove it; cannot be provided while bill-to mirrors ship-to.

`CustomerUpdateItemInput.contactName` ● `String` scalar common

Named primary contact for a business customer.

`CustomerUpdateItemInput.contactTitle` ● `String` scalar common

Role or title of the named primary contact.

`CustomerUpdateItemInput.contacts` ● `[CustomerContactUpdateInput!]` list input common

Contact changes. Omit id to add, include id to edit, or id and delete to archive. Omitted contacts are unchanged.

`CustomerUpdateItemInput.customerType` ● `CustomerTypeEnum` enum people

The kind of buying entity.

`CustomerUpdateItemInput.defaultTemplateId` ● `ID` scalar common

Default B2B template for the customer's orders.

`CustomerUpdateItemInput.defaultView` ● `CustomerViewEnum` enum common

Default customer record layout. Null follows customerType without changing the customer type.

`CustomerUpdateItemInput.email` ● `String` scalar common

Contact email.

`CustomerUpdateItemInput.freightPayer` ● `FreightPayerEnum` enum people

Who pays freight on this customer's shipments.

`CustomerUpdateItemInput.handle` ● `String` scalar common

Optional stable identifier unique within the company; useful as an upsert key for uploads.

`CustomerUpdateItemInput.id` ● `ID!` non-null scalar common

The customer to update.

`CustomerUpdateItemInput.legalName` ● `String` scalar common

The registered legal entity name, when it differs from the display name - what belongs on invoices, tax documents and contracts.

`CustomerUpdateItemInput.locations` ● `[CustomerLocationUpdateInput!]` list input common

Changes to saved locations; other locations remain unchanged.

`CustomerUpdateItemInput.name` ● `String` scalar common

Display name of the buying entity.

`CustomerUpdateItemInput.notes` ● `String` scalar common

Internal notes about the customer relationship.

`CustomerUpdateItemInput.parentId` ● `ID` scalar common

Parent customer for single-level family rollup.

`CustomerUpdateItemInput.paymentTerms` ● `String` scalar common

Payment terms label (e.g. "Net 30").

`CustomerUpdateItemInput.phone` ● `String` scalar common

General contact phone for the relationship, distinct from the ship-to and bill-to snapshots on an order.

`CustomerUpdateItemInput.preferredContactMethod` ● `PreferredContactMethodEnum` enum people

The customer's stated preferred communication channel.

`CustomerUpdateItemInput.preferredLanguage` ● `String` scalar common

The customer's stated preferred language.

`CustomerUpdateItemInput.salesChannelId` ● `ID` scalar common

The customer's home sales channel.

`CustomerUpdateItemInput.shipToCompany` ● `String` scalar common

Default ship-to company name.

`CustomerUpdateItemInput.shipToEmail` ● `String` scalar common

Default ship-to contact email.

`CustomerUpdateItemInput.shipToName` ● `String` scalar common

Default ship-to contact name.

`CustomerUpdateItemInput.shipToPhone` ● `String` scalar common

Default ship-to contact phone.

`CustomerUpdateItemInput.shippingAccounts` ● `[CustomerShippingAccountInput!]` list input people

Carrier accounts billed for this customer's shipments. Replaces the full set; include ids to keep existing rows; pass [] to remove all.

`CustomerUpdateItemInput.shippingAddress` ● `CustomerAddressInput` input common

Default shipping address. Pass null to remove it.

`CustomerUpdateItemInput.startDate` ● `ISO8601Date` scalar common

The calendar date when the customer relationship began. Pass null to clear it.

`CustomerUpdateItemInput.taxExempt` ● `Boolean` scalar common

Whether the customer is exempt from sales tax.

`CustomerUpdateItemInput.taxId` ● `String` scalar common

The buying entity's tax identification number.

`CustomerUpdateItemInput.website` ● `String` scalar common

The buying entity's website URL.

Member Of

BulkUpdateCustomersInput input

Fields
Member Of