← All types
Sales & CRMIn Input object

UpsertCustomerInput

Input for creating or updating a customer

Fields

id

CustomerIDOptional

ID for update; omit for create

name

String!Required

Customer name (required)

External system reference

The tenant's own account number for this customer (unique per tenant)

HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.

email

StringOptional

Primary email address

phone

StringOptional

Primary phone number

notes

StringOptional

General notes

Whether the customer is active

Credit limit amount (nil = no limit)

Currency for credit limit (ISO 4217)

Net payment terms in days (0 = prepayment)

Place customer on credit hold

Reason for credit hold

Default tax code for this customer's documents

Whether the customer is tax exempt

Tax exemption certificate or VAT number

Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.

Override update timestamp (ISO8601). Honored on create or update; defaults to now.

Referenced by (2)
Exact type SDL
"""Input for creating or updating a customer"""
input UpsertCustomerInput {
  """ID for update; omit for create"""
  id: CustomerID
  """Customer name (required)"""
  name: String!
  """External system reference"""
  externalId: String
  """The tenant's own account number for this customer (unique per tenant)"""
  customerNumber: String
  """
  HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.
  """
  externalUrl: String
  """Primary email address"""
  email: String
  """Primary phone number"""
  phone: String
  """General notes"""
  notes: String
  """Whether the customer is active"""
  isActive: Boolean
  """Credit limit amount (nil = no limit)"""
  creditLimit: Float
  """Currency for credit limit (ISO 4217)"""
  creditCurrency: CurrencyISO
  """Net payment terms in days (0 = prepayment)"""
  paymentTermsDays: Int
  """Place customer on credit hold"""
  isCreditHold: Boolean
  """Reason for credit hold"""
  creditHoldReason: String
  """Default tax code for this customer's documents"""
  defaultTaxCodeId: TaxCodeID
  """Whether the customer is tax exempt"""
  isTaxExempt: Boolean
  """Tax exemption certificate or VAT number"""
  taxExemptReference: String
  """
  Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.
  """
  createdAt: ISO8601
  """
  Override update timestamp (ISO8601). Honored on create or update; defaults to now.
  """
  updatedAt: ISO8601
}