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!]
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
parentCompanyId: Int
company: Company
managedCompanies: [Company!]
companies(
input: ContactCompaniesSearchInput
): CompaniesResponse
sources: [Source!]!
purchaseAuthorizationConfigs(
input: ContactPurchaseAuthorizationConfigSearchInput
): PurchaseAuthorizationConfigResponse
}
Fields
Contact.contactId
● Int!
non-null scalar
Unique identifier for the contact.
This is the primary key used to reference the contact throughout the system and in relationships with other entities.
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
Get all magic tokens for a contact
Contact.favoriteLists
● FavoriteListsResponse
object
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.userId
● Int
scalar
Unique identifier for the user.
Primary key used to reference the user throughout the system and establish relationships with other entities.
Contact.debtorId
● String
deprecated scalar
Deprecated in favor of company debtorId
Financial identifier for billing and accounting purposes.
Links the user to financial records and billing systems for transaction processing and account management.
Contact.gender
● Gender
enum
Gender of the contact.
Used for personalization and communication preferences. Optional field that respects privacy preferences.
Contact.firstName
● String!
non-null scalar
First name of the contact.
Given name used for personal identification and communication. Required field for contact creation.
Contact.middleName
● String
scalar
Middle name or initial of the contact.
Additional name component used for formal identification when available.
Contact.lastName
● String!
non-null scalar
Last name of the contact.
Family name or surname used for identification and formal communication. Required field for contact creation.
Contact.phone
● String
scalar
Primary phone number of the contact.
Main business or personal phone number for voice communication. Should include country code for international numbers.
Contact.mobile
● String
scalar
Mobile phone number of the contact.
Mobile or cellular phone number for direct communication and SMS notifications.
Contact.email
● String!
non-null scalar
Email address of the contact.
Primary email address used for communication, notifications, and authentication. Must be unique across the system.
Contact.login
● String
scalar
Login username for authentication.
Username used for system authentication. If not provided, email address is used as the login identifier.
Contact.iban
● String
scalar
International Bank Account Number for payments.
IBAN used for international bank transfers and payment processing. Must follow international IBAN format standards.
Contact.bankAccount
● String
scalar
Bank account number for domestic payments.
Local bank account number used for domestic payment processing and financial transactions.
Contact.bic
● String
scalar
Bank Identifier Code for international transfers.
BIC/SWIFT code used to identify the bank for international wire transfers and payments.
Contact.notes
● String
scalar
Additional notes or comments about the contact.
Free-form text field for storing additional information, special instructions, or internal notes about the contact.
Contact.primaryLanguage
● String
scalar
Preferred language for communication.
Language code (e.g., 'EN', 'NL', 'DE') used for localized communications and interface display.
Contact.expires
● DateTime
scalar
Account expiration date.
Date when the contact's access expires. After this date, the contact cannot authenticate or access the system.
Contact.externalId
● String
scalar
External system identifier.
Reference ID used to link this contact with records in external systems or legacy databases.
Contact.dateOfBirth
● DateTime
scalar
Date of birth of the contact.
Used for age verification, personalization, and compliance with age-related regulations.
Contact.mailingList
● YesNo
enum
Mailing list subscription preference.
Indicates whether the contact has opted in to receive marketing communications and newsletters.
Contact.isLoggedIn
● Boolean
scalar
Current authentication status.
Indicates whether the contact is currently logged into the system. Updated in real-time based on session status.
Contact.createdAt
● DateTime
scalar
Timestamp when the contact was created.
Automatically set when the contact is first created in the system. Used for auditing and tracking purposes.
Contact.lastModifiedAt
● DateTime
scalar
Timestamp when the contact was last modified.
Automatically updated whenever any contact information is changed. Used for auditing and synchronization purposes.
Contact.parentCompanyId
● Int
scalar
Identifier of the primary company this contact belongs to.
References the main company association for this contact. Used for organizational hierarchy and permission inheritance.
Contact.company
● Company
object
Primary company associated with this contact.
The main company that this contact belongs to, providing organizational context and access permissions.
Contact.managedCompanies
● [Company!]
list object
Companies that this contact manages.
List of companies where this contact has management responsibilities and elevated permissions.
Contact.companies
● CompaniesResponse
object
All companies this contact is associated with.
Paginated list of all company relationships for this contact, including primary company and additional associations.
Contact.companies.input
● ContactCompaniesSearchInput
input
Contact.sources
● [Source!]!
non-null object
Contact.purchaseAuthorizationConfigs
● PurchaseAuthorizationConfigResponse
object
All purchase authorization config entities for this contact
Contact.purchaseAuthorizationConfigs.input
● ContactPurchaseAuthorizationConfigSearchInput
input
Interfaces
IBaseUser
interface
Base interface for all user types in the system.
Defines common properties shared across users, contacts, and customers. This interface provides a unified structure for user-related data while allowing for type-specific implementations.
Returned By
contact
query ● contactCreate
mutation ● contactUpdate
mutation
Member Of
Cart
object ● ContactAddToCompaniesResponse
object ● ContactRemoveFromCompaniesResponse
object ● ContactsResponse
object ● FavoriteList
object ● MagicToken
object ● OrderRevision
object ● Pricesheet
object ● PurchaseAuthorizationConfig
object ● Tender
object