OBJECT
ContactEntity
Person the sales team works with, usually linked to one or more accounts, leads and opportunities.
link GraphQL Schema definition
- type ContactEntity {
- # Values of the record's custom fields as a JSON object keyed by custom field
- # apiName (camelCase).
- #
- # Arguments
- # apiNames: Api names of custom fields to retrieve. All are
- # returned if not set.
- (: [String!]): JSONString!
- # Filled only when a single record is read by its id; otherwise null or an empty
- # list.
- : Int
- # True when the record is protected against deletion because it must always exist
- # in the space. Deleting a record that is not protected can still fail on other
- # checks. Read-only.
- : Boolean!
- # Unique identifier of entity.
- : ID!
- # Specifies if the entity is considered deleted.
- : Boolean
- # Last modification time.
- : DateTime
- # Creation time.
- : DateTime
- # Contact type that classifies this contact. Contact types are configurable per
- # team space and drive which form, fields and pipelines apply.
- : ContactTypeEntity
- # Currency exchange rate list used to convert monetary fields linked to this
- # contact. Empty to inherit the team space default.
- : CurrencyExchangeRatesListEntity
- # Sales user who owns this contact.
- : ClientEntity
- # Profile picture associated with the contact.
- : CloudObjectEntity
- # Sales unit this contact is assigned to. Determines which team members can see
- # the record under unit-based sharing.
- : SalesUnitEntity
- # Street address of the contact.
- : String
- # City of the contact address.
- : String
- # Free-form notes describing the contact.
- : String
- # Id of the contact type assigned to this contact.
- : ID
- # Country of the contact address.
- : String
- # Id of the currency exchange rate list applied to this contact.
- : ID
- # Primary email address of the contact. Used as default recipient for emails sent
- # from Coevera.
- : String
- # Additional email address.
- : String
- # Additional email address.
- : String
- # Additional email address.
- : String
- # Additional email address.
- : String
- # Given name of the contact.
- : String
- # Gender of the contact: Unknown when not specified, Male, Female or NonBinary.
- : GenderEnum
- # True when the contact has been archived. Archived contacts remain readable but
- # are hidden from active lists and cannot be edited until reactivated.
- : Boolean
- # Family name of the contact.
- : String
- # Middle name of the contact, if applicable.
- : String
- # Id of the contact owner.
- : ID!
- # Primary phone number of the contact. Used as default target for click-to-call.
- : String
- # Additional phone number.
- : String
- # Additional phone number.
- : String
- # Additional phone number.
- : String
- # Additional phone number.
- : String
- # Id of the profile picture document.
- : ID
- # Job title or position of the contact.
- : String
- # Free-text company name used when the contact is not linked to an actual Account
- # record. Lets integrators capture the company without creating a separate
- # Account.
- : String
- # Sharing model applied on top of the owner/unit visibility (e.g. shared with
- # selected sales units or selected users). The matching sharingUnits /
- # sharingClients lists control who is granted access.
- : ShareModeEnum
- # State or province of the contact address.
- : String
- # Honorific or salutation prefix (e.g. Mr., Ms., Dr.) shown before the name.
- : String
- # Id of the sales unit.
- : ID
- # ZIP or postal code of the contact address.
- : String
- # Revision when entity was lastly changed.
- : Int
- # Display version of the contact name (title, first, middle, last). Used in lists
- # and references.
- : String!
- # Number of email sequences this record is currently actively enrolled in
- # (soft-deleted or ended enrollments are not counted).
- : Int!
- # Social network profiles linked to this contact (e.g. LinkedIn, Facebook).
- : ContactSocialRelationEntity
- # Primary account this contact belongs to. Set automatically when the contact has
- # an account relation marked as primary.
- : AccountEntity
- # Accounts this contact is linked to. Each link records the role and position the
- # contact has at the related account.
- #
- # Arguments
- # filter: Filter Account relations by target Account attributes.
- # filterEdge: Filter ContactAccountRelation relations by edge
- # (relation) ContactAccountRelation attributes.
- # orderBy: Order Account relations by target Account attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : AccountFilterInput,
- : ContactAccountRelationFilterInput,
- : [AccountOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): ContactAccountRelationEntityConnection
- # Sales units that have been granted shared access to this contact. Editable only
- # when shareMode allows unit sharing.
- #
- # Arguments
- # filter: Filter SalesUnit relations by target SalesUnit
- # attributes.
- # filterEdge: Filter ContactSharingSalesUnitRelation relations by
- # edge (relation) ContactSharingSalesUnitRelation attributes.
- # orderBy: Order SalesUnit relations by target SalesUnit
- # attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : SalesUnitFilterInput,
- : ContactSharingSalesUnitRelationFilterInput,
- : [SalesUnitOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): ContactSharingSalesUnitRelationEntityConnection
- # Users that have been granted shared access to this contact. Editable only when
- # shareMode allows user sharing.
- #
- # Arguments
- # filter: Filter Client relations by target Client attributes.
- # filterEdge: Filter ContactSharingClientRelation relations by
- # edge (relation) ContactSharingClientRelation attributes.
- # orderBy: Order Client relations by target Client attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : ClientFilterInput,
- : ContactSharingClientRelationFilterInput,
- : [ClientOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): ContactSharingClientRelationEntityConnection
- # Documents linked to this contact.
- #
- # Arguments
- # filter: Filter CloudObject relations by target CloudObject
- # attributes.
- # filterEdge: Filter CloudObjectRelation relations by edge
- # (relation) CloudObjectRelation attributes.
- # orderBy: Order CloudObject relations by target CloudObject
- # attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : CloudObjectFilterInput,
- : CloudObjectRelationFilterInput,
- : [CloudObjectOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): CloudObjectRelationEntityConnection
- # External identifier of the record in the linked third-party service (e.g.
- # Google, Microsoft 365, Exchange). Maintained by the sync engine.
- : String
- # External identifier of the record in the linked third-party service (e.g.
- # Google, Microsoft 365, Exchange). Maintained by the sync engine.
- : String
- # External identifier of the record in the linked third-party service (e.g.
- # Google, Microsoft 365, Exchange). Maintained by the sync engine.
- : String
- # True when the current authenticated user has marked this contact as favorite.
- # Per-user.
- : Boolean!
- # Roles of Contact in his primary Account.
- : [ContactAccountAccountRoleRelationEntity!]
- # Job position of Contact in his primary Account.
- : String
- # Job position of Contact in his primary Account or quick account position if
- # Contact has no primary Account.
- : String
- # Filled only when a single record is read by its id; otherwise null or an empty
- # list.
- : [UUID!]!
- # If account has any unsubscribed email.
- : Boolean
- # Tag labels applied to this contact.
- #
- # Arguments
- # filter: Filter Tag relations by target Tag attributes.
- # filterEdge: Filter TagRelation relations by edge (relation)
- # TagRelation attributes.
- # orderBy: Order Tag relations by target Tag attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : TagFilterInput,
- : TagRelationFilterInput,
- : [TagOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): TagRelationEntityConnection
- # Saved view profiles this contact currently matches.
- #
- # Arguments
- # filter: Filter Profile relations by target Profile attributes.
- # filterEdge: Filter ProfileRelation relations by edge (relation)
- # ProfileRelation attributes.
- # orderBy: Order Profile relations by target Profile attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : ProfileFilterInput,
- : ProfileRelationFilterInput,
- : [ProfileOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): ProfileRelationEntityConnection
- # Org chart relationship of Contact in his primary Account.
- : String
- # Timestamp of the most recent modification made by an end user (excluding system
- # changes). Read-only; computed by Coevera.
- : DateTime
- # Permissions the current user has on this record, out of the requested ones.
- #
- # Arguments
- # permissions: Permissions to check; the result lists those the
- # current user has.
- (: [EntityPermsEnum!]!): [EntityPermsEnum!]!
- # Records of the given entity type that are related to this record, as a drilldown
- # list.
- #
- # Arguments
- # entityType: Entity type of the related records to list.
- (: EntityNameEnum!): CompactViewDrilldownModel!
- # Data of the given preview pane charts and lists, computed for this record.
- #
- # Arguments
- # ids: Ids of the charts to compute, taken from the charts of the
- # record type's interface preview. Comment charts are not supported.
- (: [UUID!]!): [DashboardChartData!]
- # Records behind one preview pane chart of this record: all records of a list
- # chart, or the records of a single data point of a report chart.
- #
- # Arguments
- # id: Id of the chart, taken from the charts of the record type's
- # interface preview.
- # seriesIndex: Index of the series of the drilled-down data
- # point. Required for report charts; must not be set for list charts.
- # itemIndex: Index of the drilled-down data point within its
- # series. Required for report charts; must not be set for list charts.
- (: UUID!, : Int, : Int): CompactViewDrilldownModel!
- # Values of the fields shown in the record's preview pane, as configured for the
- # record's type.
- #
- # Arguments
- # ids: Ids of the fields to return. When not set, the fields
- # configured for the preview pane of the record's type are returned.
- # first: Maximum number of preview pane fields to return when ids
- # is not set; fields pinned by the current user come first.
- (: [UUID!], : Int): [InterfaceFieldData]!
- # Approval request of this record that is pending or was rejected; null when there
- # is none or it was approved.
- : ApprovalEntity
- }
link Require by
- ActivityRelationEntityLink of a task or an appointment to a record it concerns, such as an account, contact, lead, opportunity, project or quote.
- AppointmentContactInviteesRelationEntityInvitation of an external person to an appointment, identified by email and matched to a contact when one exists, with their response.
- ApprovalEntityApproval request that an approval process raised for a record, such as a quote or an opportunity, waiting for the decision of its approvers.
- ArchiveContactPayloadResult of the archiveContact mutation.
- CallEntityPhone call logged in the space, linked to the user who made it and to the contact, account, lead or opportunity it concerns.
- ChangeOwnershipContactPayloadResult of the changeOwnershipContact mutation.
- ClientFavoriteEntityRecord or screen profile that a user has marked as a favorite.
- CloudObjectRelationEntityAttachment of a file to a record, such as an account, contact, opportunity, activity or email template, optionally in a folder of that record.
- ContactAccountRelationEntityLink between a contact and an account they work for, with their position and their place in the account org chart.
- ContactAutoPrefillNew, unsaved contact pre-filled with the values of an AI suggestion, with the ids of the fields that were filled in.
- ContactDataExRelationEntityOption selected in a multi-select checkbox field of a contact; there is one link per selected option.
- ContactEntityEdgeA Relay edge containing a `ContactEntity` and its cursor.
- ContactKPIEntityRecorded KPI event of a contact, such as its creation, archiving or the first and last email sent, used in KPI reports.
- ContactRelationEntityLink between two related contacts, such as colleagues or family members; its labels give the kind of relationship.
- ContactRepositoryRead operations for Contact records.
- ContactSharingClientRelationEntitySharing of a contact with a user, as a watcher or an editor.
- ContactSharingSalesUnitRelationEntitySharing of a contact with a sales unit, as a watcher or an editor.
- ConvertContactPayloadResult of the convertContact mutation.
- CopyContactPayloadResult of the copyContact mutation.
- CreateContactPayloadResult of the createContact mutation.
- CustomEntityRelationDataEntityLink between two records made through a custom relation, such as an account linked to a custom entity record.
- DashboardListChartDataEntityOne record shown in a dashboard list chart, in the field matching its kind.
- DeleteContactPayloadResult of the deleteContact mutation.
- EmailEntityEmail message sent or received by users of the space, linked to the contacts, accounts and other records it concerns.
- EmailSequenceEnrolledEntityRecord enrolled in an email sequence, such as a contact, lead or opportunity, with the run that enrolled it.
- LeadEntityPotential sale in its early stage that moves through a lead process until it is qualified into an opportunity or lost.
- LeadOpptyContactRelationEntityLink between a lead or opportunity and a contact, with the contact's sales roles and org-chart position.
- ManageSharingContactPayloadResult of the manageSharingContact mutation.
- MergeContactPayloadResult of the mergeContact mutation.
- MessageRelationEntityLink between a message (email or memo) and a record such as an account, contact, lead or opportunity.
- NoteEntityNote a user wrote on a record such as an account, contact, lead, opportunity, project or quote.
- OnlineFormEntitySubmission (response) of an online form, with the answers and the records it created or updated.
- OnlineFormRelationEntityLink between an online form submission and a record it created or updated.
- OnlineFormTypeEmailRelationEntityEmail that sent an online form link to a recipient, with the record it was sent on.
- OpportunityEntityPotential deal with a value and closing date that moves through the steps of a sales pipeline until it is won or lost.
- ProfileRelationEntityRecord added explicitly to a static saved view (profile).
- ProjectContactRelationEntityLink between a project and a contact, marking the primary contact.
- ProjectEntityProject delivered for an account or run internally, with its objectives, activities and progress.
- QuoteContactRelationEntityLink between a quote and a contact, marking the primary contact.
- QuoteEntityPrice offer for a customer, usually prepared from an opportunity, with product line items; it moves through a quote process.
- ReactivateContactPayloadResult of the reactivateContact mutation.
- RestoreContactPayloadResult of the restoreContact mutation.
- TagRelationEntityAssignment of a tag to a record.
- TextMessageConversationEntityText message conversation between a Coevera phone number and an external phone number.
- TextMessageConversationRelationsEntityLink between a text message conversation and a record such as an account, contact, lead or opportunity.
- UpdateContactPayloadResult of the updateContact mutation.