OBJECT
LeadEntity
Potential sale in its early stage that moves through a lead process until it is qualified into an opportunity or lost.
link GraphQL Schema definition
- type LeadEntity {
- # 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
- # Currency exchange rate list used to convert monetary fields linked to this lead.
- # Empty to inherit the team space default.
- : CurrencyExchangeRatesListEntity
- # How the lead originated (e.g. Website, Referral, Trade Show). Configurable per
- # team space.
- : DataEntity
- # Lead type that classifies this lead. Lead types are configurable per team space
- # and drive which form, fields and lead process apply.
- : LeadTypeEntity
- # Sales user who owns this lead. May be empty when the lead is unassigned and
- # available for take-over.
- : ClientEntity
- # Configurable reason recorded when the lead is archived (lost). Required when the
- # lost form mandates it.
- : DataEntity
- # Step in the lead process the lead is currently in.
- : StepEntity
- # Sales unit this lead is assigned to. Determines which team members can see the
- # record under unit-based sharing.
- : SalesUnitEntity
- # Id of the currency exchange rate list applied to this lead.
- : ID
- # Free-form description of the lead.
- : String
- # True when the lead has been archived (lost). Archived leads remain readable but
- # are hidden from active lists and cannot be edited until reactivated.
- : Boolean
- # User-set colored flag used to highlight the lead in lists and reports.
- : Int
- # Time when an AI-suggested buying center was last applied to this lead.
- : DateTime
- # Id of the lead source recording how the lead originated (e.g. Website, Referral,
- # Trade Show).
- : ID
- # Id of the lead type that classifies the lead and drives which form, fields and
- # lead process apply.
- : ID
- # Name of the entity and its default text representation.
- : String!
- # Id of the lead owner.
- : ID
- # Free-text company email captured at lead creation when no Account record has
- # been linked yet.
- : String
- # Free-text company name captured at lead creation when no Account record has been
- # linked yet.
- : String
- # Free-text company phone captured at lead creation when no Account record has
- # been linked yet.
- : String
- # Free-text contact name captured at lead creation when no Contact record has been
- # linked yet.
- : String
- # Free-text contact email captured at lead creation when no Contact record has
- # been linked yet.
- : String
- # Free-text contact phone captured at lead creation when no Contact record has
- # been linked yet.
- : String
- # Qualitative ranking score (1-10) the user assigns to indicate the strength of
- # the lead.
- : Int
- # Free-form note explaining why the lead was archived (lost). Captured alongside
- # reasonOfClose.
- : String
- # Id of the reason recorded when the lead is archived (lost), or empty when none
- # was given.
- : ID
- # 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
- # Id of the lead process step.
- : ID
- # Discriminator identifying the concrete record type — always "lead" for Lead
- # records. Read-only; useful when consuming polymorphic LeadOppty results.
- : String!
- # Id of the sales unit.
- : ID
- # Revision when entity was lastly changed.
- : Int
- # Primary contact of this lead. Set automatically from the contact relation marked
- # as primary.
- : ContactEntity
- # Primary account of this lead. Set automatically from the account relation marked
- # as primary.
- : AccountEntity
- # Contacts linked to this lead, including their roles and org-chart positions.
- #
- # Arguments
- # filter: Filter Contact relations by target Contact attributes.
- # filterEdge: Filter LeadOpptyContactRelation relations by edge
- # (relation) LeadOpptyContactRelation attributes.
- # orderBy: Order Contact relations by target Contact 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.
- (
- : ContactFilterInput,
- : LeadOpptyContactRelationFilterInput,
- : [ContactOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): LeadOpptyContactRelationEntityConnection
- # Accounts linked to this lead, including the primary-account flag.
- #
- # Arguments
- # filter: Filter Account relations by target Account attributes.
- # filterEdge: Filter LeadOpptyAccountRelation relations by edge
- # (relation) LeadOpptyAccountRelation 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,
- : LeadOpptyAccountRelationFilterInput,
- : [AccountOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): LeadOpptyAccountRelationEntityConnection
- # Current status of the lead (Open, Lost, Qualified). Read-only; derived from the
- # archived flag and lifecycle events.
- : LeadStatusEnum!
- # Sales units that have been granted shared access to this lead. Editable only
- # when shareMode allows unit sharing.
- #
- # Arguments
- # filter: Filter SalesUnit relations by target SalesUnit
- # attributes.
- # filterEdge: Filter LeadOpptySharingSalesUnitRelation relations
- # by edge (relation) LeadOpptySharingSalesUnitRelation 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,
- : LeadOpptySharingSalesUnitRelationFilterInput,
- : [SalesUnitOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): LeadOpptySharingSalesUnitRelationEntityConnection
- # Users that have been granted shared access to this lead. Editable only when
- # shareMode allows user sharing.
- #
- # Arguments
- # filter: Filter Client relations by target Client attributes.
- # filterEdge: Filter LeadOpptySharingClientRelation relations by
- # edge (relation) LeadOpptySharingClientRelation 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,
- : LeadOpptySharingClientRelationFilterInput,
- : [ClientOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): LeadOpptySharingClientRelationEntityConnection
- # Documents linked to this lead.
- #
- # 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
- # Number of email sequences this record is currently actively enrolled in
- # (soft-deleted or ended enrollments are not counted).
- : Int!
- # Tag labels applied to this lead.
- #
- # 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 lead 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
- # Timestamp of when the lead was qualified, taken from the matching KPI event.
- # Empty for leads that have not been qualified. Read-only.
- : DateTime
- # Number of days the lead has been sitting in its current pipeline step.
- # Read-only; computed by Coevera from the most recent move event.
- : Int!
- # Filled only when a single record is read by its id; otherwise null or an empty
- # list.
- : WarningLevelEnum
- # Filled only when a single record is read by its id; otherwise null or an empty
- # list.
- : FitnessDescription
- # True when the current authenticated user has marked this lead as favorite.
- # Per-user.
- : Boolean!
- # Timestamp of when the lead was archived (lost). Setting it adjusts the
- # underlying loss event; empty for leads that have not been archived.
- : DateTime
- # Display version of the lead name, used in lists and references.
- : String!
- # Lead scoring summary, combining the percentile and current scoring state.
- # Read-only; computed by Coevera.
- : EntityScoringResult
- # Filled only when a single record is read by its id; otherwise null or an empty
- # list.
- : [UUID!]!
- # 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]!
- # Checklist items of the steps of the record's lead process, with the completion
- # state of each item for this record.
- #
- # Arguments
- # stepChecklistIds: Ids of the step checklist items to return.
- # When not set, the items of all steps of the record's lead process are returned.
- (: [UUID]): [StepChecklistActivityItem]!
- # 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.
- ApprovalEntityApproval request that an approval process raised for a record, such as a quote or an opportunity, waiting for the decision of its approvers.
- ArchiveLeadPayloadResult of the archiveLead mutation.
- BackToLeadPayloadResult of the backToLead mutation.
- CallEntityPhone call logged in the space, linked to the user who made it and to the contact, account, lead or opportunity it concerns.
- ChangeLabelFlagLeadPayloadResult of the changeLabelFlagLead mutation.
- ChangeLeadProcessPayloadResult of the changeLeadProcess mutation.
- ChangeOwnershipLeadPayloadResult of the changeOwnershipLead 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.
- ConvertLeadPayloadResult of the convertLead mutation.
- CopyLeadPayloadResult of the copyLead mutation.
- CreateLeadPayloadResult of the createLead 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.
- DeleteLeadPayloadResult of the deleteLead mutation.
- EmailSequenceEnrolledEntityRecord enrolled in an email sequence, such as a contact, lead or opportunity, with the run that enrolled it.
- GhostLeadOpptyContactRelationEntityPlacement of a ghost contact on the org chart of a lead or an opportunity.
- LeadAutoPrefillNew, unsaved lead pre-filled with the values of an AI suggestion, with the ids of the fields that were filled in.
- LeadEntityEdgeA Relay edge containing a `LeadEntity` and its cursor.
- LeadOpportunityEntityEither a lead or an opportunity.
- LeadOpptyAccountRelationEntityLink between a lead or opportunity and an account, marking the primary account.
- LeadOpptyContactGroupRelationEntityGroup of contacts on the org chart of a lead or opportunity.
- LeadOpptyContactRelationEntityLink between a lead or opportunity and a contact, with the contact's sales roles and org-chart position.
- LeadOpptyDataExRelationEntityOption selected in a multi-select checkbox field of a lead or opportunity.
- LeadOpptyKPIEntityKPI event of a lead or opportunity (e.g. created, qualified, won, lost or moved to another step), used in activity reporting.
- LeadOpptySharingClientRelationEntityShare of a lead or opportunity with an individual user, with the access level granted.
- LeadOpptySharingSalesUnitRelationEntityShare of a lead or opportunity with a sales unit, with the access level granted.
- LeadOpptyStepCheckListRelationEntityCompletion of a step checklist item on a lead, opportunity or quote, with the activity, email, note or document that fulfils it.
- LeadRepositoryRead operations for Lead records.
- ManageSharingLeadPayloadResult of the manageSharingLead mutation.
- MessageRelationEntityLink between a message (email or memo) and a record such as an account, contact, lead or opportunity.
- MoveLeadPayloadResult of the moveLead mutation.
- 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.
- ProfileRelationEntityRecord added explicitly to a static saved view (profile).
- ReactivateLeadPayloadResult of the reactivateLead mutation.
- ReleaseOwnershipLeadPayloadResult of the releaseOwnershipLead mutation.
- RestoreLeadPayloadResult of the restoreLead mutation.
- TagRelationEntityAssignment of a tag to a record.
- TextMessageConversationRelationsEntityLink between a text message conversation and a record such as an account, contact, lead or opportunity.
- TimeframeEntityTime a lead or opportunity has spent in a pipeline step.
- UpdateLeadPayloadResult of the updateLead mutation.