Contact

Contact entity representing individual contacts and business relationships.

External entity from the contact service that provides contact identification and relationship information. Used as a reference for contact-specific attributes and relationship management within the attribute system.

type Contact implements IBaseUser {
  contactId: Int!
  attributes(input: AttributeResultSearchInput): AttributeResultResponse
  magicTokens: [MagicToken!]!
  favoriteLists(input: FavoriteListsBaseSearchInput): FavoriteListsResponse
  orderlists(input: OrderlistSearchInput): OrderlistsResponse
  pricesheets: [Pricesheet!]
  pricesheetsEffective(
    input: PricesheetsEffectivePaginationInput
  ): PricesheetResponse!
  userId: Int
  debtorId: String @deprecated
  gender: Gender
  firstName: String!
  middleName: String
  lastName: String!
  phone: String
  mobile: String
  email: String
  login: String
  iban: String
  bankAccount: String
  bic: String
  notes: String
  primaryLanguage: String
  expires: DateTime
  externalId: String
  dateOfBirth: DateTime
  mailingList: YesNo
  isLoggedIn: Boolean
  createdAt: DateTime
  lastModifiedAt: DateTime
  uuid: String
  parentCompanyId: Int
  company: Company
  managedCompanies: [Company!]
  sources: [Source!]
  companies(input: ContactCompaniesSearchInput): CompaniesResponse
  purchaseAuthorizationConfigs(
    input: ContactPurchaseAuthorizationConfigSearchInput
  ): PurchaseAuthorizationConfigResponse
}

Fields

`Contact.contactId` ● `Int!` non-null scalar

Contact unique identifier

`Contact.attributes` ● `AttributeResultResponse` object

Lists attributes for this contacts based on the search input.

`Contact.attributes.input` ● `AttributeResultSearchInput` input

`Contact.magicTokens` ● `[MagicToken!]!` non-null object

Retrieve all magic tokens associated with this contact.

Returns a complete list of magic tokens that belong to this contact, including active, expired, and used tokens. Useful for authentication management and token usage tracking.

`Contact.favoriteLists` ● `FavoriteListsResponse` object

Collection of favorite lists associated with this contact.

Returns paginated results of all favorite lists owned by this contact. Includes both default and non-default lists with their complete metadata and content.

**Response Structure**:

Paginated list of personal favorite lists
Complete favorite list metadata
Associated products and clusters
Creation and modification timestamps

**Filtering Capabilities**:

Search by list name
Filter by default status
Date range filtering
Content-based filtering

**Use Cases**:

Personal shopping lists
Sales tool organization
Individual product preferences
Quick access to frequently used items

`Contact.favoriteLists.input` ● `FavoriteListsBaseSearchInput` input

`Contact.orderlists` ● `OrderlistsResponse` object

Order lists that are assigned to or accessible by this contact.

Returns a paginated collection of order lists where this contact has been granted access. The contact will be able to see and order from these lists based on their permissions. Results can be filtered using the input parameter for more specific queries.

`Contact.orderlists.input` ● `OrderlistSearchInput` input

Search and filtering criteria for order lists assigned to this contact.

Filters the results to show only order lists that are assigned to or accessible by this specific contact. All standard search criteria can be applied in addition to the contact-specific filtering.

If not provided, returns all order lists accessible to this contact with default pagination settings.

Validation: All provided search criteria must be valid according to their respective field requirements.

`Contact.pricesheets` ● `[Pricesheet!]` list object

`Contact.pricesheetsEffective` ● `PricesheetResponse!` non-null object

Get effective pricesheets for this contact.

Returns all pricesheets that apply to this contact, including directly assigned pricesheets, company pricesheets, and pricesheets linked via usergroups. Results are ordered by priority (highest first) and paginated.