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.
Contact.pricesheetsEffective.input ● PricesheetsEffectivePaginationInput input
Optional input parameters for pagination and company selection.
You can optionally specify companyId (defaults to contact's default company if omitted).
Contact.userId ● Int scalar
The unique identifier of the user.
Contact.debtorId ● String deprecated scalar
Deprecated in favor of company debtorId
Deprecated in favor of company debtorId
Contact.gender ● Gender enum
Contact gender
Contact.firstName ● String! non-null scalar
Contact's first name for personal identification and communication
Contact.middleName ● String scalar
Contact's middle name or initial for complete personal identification
Contact.lastName ● String! non-null scalar
Contact's last name for personal identification and formal communication
Contact.phone ● String scalar
Primary phone number for business communication and contact purposes
Contact.mobile ● String scalar
Mobile phone number for urgent communication and SMS notifications
Contact.email ● String scalar
Primary email address for business communication and notifications
Contact.login ● String scalar
Contact login
Contact.iban ● String scalar
Contact IBAN
Contact.bankAccount ● String scalar
Contact bank account number
Contact.bic ● String scalar
Contact BIC code
Contact.notes ● String scalar
Contact notes
Contact.primaryLanguage ● String scalar
Contact primary language
Contact.expires ● DateTime scalar
Contact expiration date
Contact.externalId ● String scalar
External ID
Contact.dateOfBirth ● DateTime scalar
Contact date of birth
Contact.mailingList ● YesNo enum
Whether the contact is subscribed to mailing list
Contact.isLoggedIn ● Boolean scalar
Whether the contact is currently logged in
Contact.createdAt ● DateTime scalar
Timestamp when the entity record was initially created in the system
Contact.lastModifiedAt ● DateTime scalar
Timestamp of the most recent modification to the entity record
Contact.uuid ● String scalar
Universally unique identifier (UUID) providing global uniqueness across systems
Contact.parentCompanyId ● Int scalar
The primary company ID for the contact
Contact.company ● Company object
Contact company
Contact.managedCompanies ● [Company!] list object
Managed companies
Contact.sources ● [Source!] list object
External system sources that contributed to this entity's data for traceability and integration
Contact.companies ● CompaniesResponse object
All companies associated with this contact through various business relationships
Contact.companies.input ● ContactCompaniesSearchInput input
Search criteria for filtering and paginating associated companies
Contact.purchaseAuthorizationConfigs ● PurchaseAuthorizationConfigResponse object
Purchase authorization configurations that apply to this contact for spending limits and approval workflows
Contact.purchaseAuthorizationConfigs.input ● ContactPurchaseAuthorizationConfigSearchInput input
Search criteria for filtering purchase authorization configurations
Interfaces
IBaseUser interface
Interface for the BaseUser Type, where both Contacts and Customers derive from
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