← All types
Sales & CRMIn Input object

UpsertContactInput

Input for creating or updating a contact. At least one nonblank firstName, lastName, email, phone, or externalId is required.

Fields

id

ContactIDOptional

ID for update; omit for create

Associated customer ID (required)

External system identifier

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.

Contact's first name (optional)

Contact's last name (optional)

email

StringOptional

Email address

phone

StringOptional

Phone number

Job title or position

Whether this is the primary contact

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 (1)
Exact type SDL
"""
Input for creating or updating a contact. At least one nonblank firstName, lastName, email, phone, or externalId is required.
"""
input UpsertContactInput {
  """ID for update; omit for create"""
  id: ContactID
  """Associated customer ID (required)"""
  customerId: CustomerID!
  """External system identifier"""
  externalId: 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
  """Contact's first name (optional)"""
  firstName: String
  """Contact's last name (optional)"""
  lastName: String
  """Email address"""
  email: String
  """Phone number"""
  phone: String
  """Job title or position"""
  jobTitle: String
  """Whether this is the primary contact"""
  isPrimary: Boolean
  """
  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
}