Developers
Set your API contextPick a region and space ID once. Every sample fills in your base URL.
Where do I find these?

In Coevera: open your space's API application and choose Show Access. It shows the space ID and the base URL, whose host starts with your region.

From the API: if you know the space ID, the discovery endpoint GET /api/discovery/spaces/{space_id} returns its region and base URLs, without credentials.

Only the region and space ID are kept, in this browser. Never paste a key or password here.

More in the quickstart

GraphQLRepositoriesemailSequence

entities.emailSequence

Read email sequence records with the emailSequence repository, and change them with the email sequence mutations. Same records as the REST EmailSequences entity.

Queries

Fields of entities { emailSequence { … } }.

KindFieldReturns
QUERYgetById(entityId: ID!)
Returns the record with the given id, or null when there is none. Deleted records are returned as well.
EmailSequenceEntity
QUERYgetByIds(entityIds: [ID!]!)
Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
[EmailSequenceEntity!]!
QUERYgetAll(limit: Int, offset: Int, filter: EmailSequenceFilterInput, orderBy: [EmailSequenceOrderByInput!], includeDeleted: Boolean)
Returns the records that match the filter, paged with limit and offset.
[EmailSequenceEntity!]!
QUERYgetByCriteria(filter: EmailSequenceFilterInput, orderBy: [EmailSequenceOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)
Returns the records that match the filter as a cursor-paginated connection.
EmailSequenceEntityConnection
QUERYgetChangedFieldsSinceRevision(id: UUID!, revision: Int!)
Returns the ids of the fields of a record that changed after the given revision. Returns an empty list for entities without change tracking.
[UUID!]!
QUERYgetByEmailSequenceCriteria(listingOptions: EmailSequenceTabDataGridViewOptionsParams!, filter: EmailSequenceFilterInput, orderBy: [EmailSequenceOrderByInput!], before: String, after: String, first: Int, last: Int)
Returns a page of email sequences filtered by owner, enabled state and status, in addition to the regular filter.
EmailSequenceEntityConnection
QUERYgetEmailSequencesForUnenroll(bulkFilter: BulkOperationInput!)
Returns the email sequences in which any of the selected records is currently enrolled, so they can be offered for unenrollment.
[EmailSequenceEntity!]!

Mutations

KindMutationDoesReturns
MUTATIONcreateEmailSequence(input: CreateEmailSequenceInput!, validationLevel: [ValidationLevel!])Create one recordCreateEmailSequencePayload
MUTATIONupdateEmailSequence(input: UpdateEmailSequenceInput!, validationLevel: [ValidationLevel!], sessionIdToUpdate: String)Update fieldsUpdateEmailSequencePayload
MUTATIONbulkUpdateEmailSequence(input: [CreateOrUpdateEmailSequenceInput!]!, deleteInput: [DeleteEmailSequenceInput!], validationLevel: [ValidationLevel!], rollbackMethod: RollbackMethod, match: MatchingInput)Create or update many; per-item resultsBulkUpdateEmailSequencePayload
MUTATIONdeleteEmailSequence(input: DeleteEmailSequenceInput!)Soft-deleteDeleteEmailSequencePayload

Types

The types this repository uses, each with its fields and their descriptions. Types several repositories share, such as PageInfo and the filter fields, are in the types index.

EmailSequenceEntity object 34 fields: isDeleteProtected, id, isDeleted, …

Automated series of emails sent step by step to the records enrolled in it, with rules for when to send and when to stop.

FieldTypeDescription
isDeleteProtectedBoolean!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.
idID!Unique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
ownerClientEntityUser who owns this email sequence.
deactivationReasonEmailSequenceDeactivationReasonEnumReason the sequence is currently disabled (e.g. Manual stop, system suspension). Read-only.
descriptionStringFree-form description of the sequence.
isEnabledBooleanMaster switch for the sequence. Read-only on this surface — change it via the enable / disable mutations.
lastSchemaChangeDateTimeTimestamp of the most recent change to settings. Read-only.
lastStatusChangeDateTimeTimestamp of the most recent change to isEnabled. Read-only.
nameString!Display name of the email sequence.
ownerIdID!Id of the email sequence owner.
settingsEmailSequenceSchemaJSON schema describing the sequence trigger, nodes (steps) and global actions (e.g. on-reply, on-bounce, on-unsubscribe). This payload conforms to the EmailSequenceSchema JSON Schema: GET /api/v100/rest/schemas/EmailSequenceSchema.json on your region's API host
typeProcessTypeEnum!Process category of the sequence (e.g. EmailSequence vs other process types).
activityLogsEmailSequenceActivityLogEntityConnection (7 args)Run history of the sequence — one log per scheduled execution.
documents[CloudObjectRelationEntity!]Attachments and other documents linked to this sequence.
enrolledEmailSequenceEnrolledEntityConnection (7 args)Enrolment records (recipients currently or previously running through the sequence).
statusProcessStatusEnumEffective status of the sequence (e.g. Scheduled, Running, Expired, Error). Read-only; derived from the active-from / active-to settings and the most recent activity log status.
lastEmailSequenceRunDateTimeTimestamp the sequence last produced a run (delivered or attempted a step).
clickRateFloatFraction of delivered emails (0–1) where at least one tracked link was clicked.
bounceRateFloatFraction of sent emails (0–1) that bounced (the recipient mailserver rejected them).
openRateFloatFraction of delivered emails (0–1) that recorded at least one open event.
replyRateFloatFraction of delivered emails (0–1) where the recipient replied.
unsubscribeRateFloatFraction of delivered emails (0–1) where the recipient unsubscribed.
createdCountInt!Total number of emails produced (queued) by the sequence across all steps.
sentCountInt!Total number of emails actually delivered by the sequence across all steps.
enrollCountInt!Number of records (Accounts/Contacts/Leads/Opportunities) currently enrolled in this sequence.
solutionsSolutionEntityConnection (4 args)Solutions whose canvas contains this record. Deleted solutions are not included.
triggerEntityNameEntityNameEnumEntity name whose records trigger automatic enrollment into this sequence (e.g. "Lead", "Contact"). Empty when the sequence is manually enrolled only.
triggerFieldIdUUIDId of the field on the trigger entity whose value change drives enrollment (e.g. a step field on a Lead). Empty when no field-based trigger is configured.
stepCountIntNumber of steps configured in the sequence.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
statsEmailSequenceStats! (1 args)Statistics of the sequence for the selected period: enrollments, sent emails, opens, clicks, replies and records created by its steps.
EmailSequenceEntityConnection object pageInfo: PageInfo!, edges: [EmailSequenceEntityEdge]!, totalCount: Int

Paginated list of EmailSequence records.

FieldTypeDescription
pageInfoPageInfo!Pagination data for this connection.
edges[EmailSequenceEntityEdge]!Contains the nodes in this connection.
totalCountIntTotal number of items in the connection.
EmailSequenceEntityEdge object node: EmailSequenceEntity, cursor: String!

A Relay edge containing a EmailSequenceEntity and its cursor.

FieldTypeDescription
nodeEmailSequenceEntityThe item at the end of the edge
cursorString!A cursor for use in pagination
EmailSequenceDeactivationReasonEnumFilterInput input eq: [EmailSequenceDeactivationReasonEnum!], NOT: EmailSequenceDeactivationReasonEnumFilterInput

Conditions on an enumeration field. Several conditions given together must all match.

Input fieldTypeDescription
eq[EmailSequenceDeactivationReasonEnum!]Matches any of the listed values.
NOTEmailSequenceDeactivationReasonEnumFilterInputMatches values that do not meet this condition.
EmailSequenceFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field

Filter conditions for EmailSequence records. Conditions on different fields are combined with AND; use OR, AND and NOT for other combinations.

Input fieldTypeDescription
OR[EmailSequenceFilterInput!]Matches records that meet at least one of the listed filters.
AND[EmailSequenceFilterInput!]Matches records that meet all of the listed filters.
NOTEmailSequenceFilterInputMatches records that do not meet this filter.
globalSearchQueryStringSearch term matched against the fields that the global search covers for this entity.
idEntityFilterStringFieldUnique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedEntityFilterDateTimeFieldLast modification time.
createdEntityFilterDateTimeFieldCreation time.
deactivationReasonEmailSequenceDeactivationReasonEnumFilterInputReason the sequence is currently disabled (e.g. Manual stop, system suspension). Read-only.
descriptionEntityFilterStringFieldFree-form description of the sequence.
isEnabledBooleanMaster switch for the sequence. Read-only on this surface — change it via the enable / disable mutations.
lastSchemaChangeEntityFilterDateTimeFieldTimestamp of the most recent change to settings. Read-only.
lastStatusChangeEntityFilterDateTimeFieldTimestamp of the most recent change to isEnabled. Read-only.
nameEntityFilterStringFieldDisplay name of the email sequence.
ownerIdEntityFilterStringFieldId of the email sequence owner.
typeProcessTypeEnumFilterInputProcess category of the sequence (e.g. EmailSequence vs other process types).
statusProcessStatusEnumEffective status of the sequence (e.g. Scheduled, Running, Expired, Error). Read-only; derived from the active-from / active-to settings and the most recent activity log status.
lastEmailSequenceRunDateTimeTimestamp the sequence last produced a run (delivered or attempted a step).
clickRateFloatFraction of delivered emails (0–1) where at least one tracked link was clicked.
bounceRateFloatFraction of sent emails (0–1) that bounced (the recipient mailserver rejected them).
openRateFloatFraction of delivered emails (0–1) that recorded at least one open event.
replyRateFloatFraction of delivered emails (0–1) where the recipient replied.
unsubscribeRateFloatFraction of delivered emails (0–1) where the recipient unsubscribed.
createdCountIntTotal number of emails produced (queued) by the sequence across all steps.
sentCountIntTotal number of emails actually delivered by the sequence across all steps.
enrollCountIntNumber of records (Accounts/Contacts/Leads/Opportunities) currently enrolled in this sequence.
triggerEntityNameEntityNameEnumEntity name whose records trigger automatic enrollment into this sequence (e.g. "Lead", "Contact"). Empty when the sequence is manually enrolled only.
triggerFieldIdUUIDId of the field on the trigger entity whose value change drives enrollment (e.g. a step field on a Lead). Empty when no field-based trigger is configured.
stepCountIntNumber of steps configured in the sequence.
ownerClientFilterInputUser who owns this email sequence. Matches records where a related record meets these conditions.
activityLogsEmailSequenceActivityLogFilterInputRun history of the sequence — one log per scheduled execution. Matches records where a related record meets these conditions.
documentsCloudObjectRelationFilterInputAttachments and other documents linked to this sequence. Matches records where a related record meets these conditions.
enrolledEmailSequenceEnrolledFilterInputEnrolment records (recipients currently or previously running through the sequence). Matches records where a related record meets these conditions.
EmailSequenceOrderByInput input Asc or Desc per field

Sorting of EmailSequence records. Set exactly one field in each item; list several items to sort by more fields, in order of priority.

Input fieldTypeDescription
idOrderByEnumUnique identifier of entity.
isDeletedOrderByEnumSpecifies if the entity is considered deleted.
modifiedOrderByEnumLast modification time.
createdOrderByEnumCreation time.
owner[ClientOrderByNestedInput!]User who owns this email sequence. Sorts by fields of the related record, listed in order of priority.
deactivationReasonOrderByEnumReason the sequence is currently disabled (e.g. Manual stop, system suspension). Read-only.
descriptionOrderByEnumFree-form description of the sequence.
isEnabledOrderByEnumMaster switch for the sequence. Read-only on this surface — change it via the enable / disable mutations.
lastSchemaChangeOrderByEnumTimestamp of the most recent change to settings. Read-only.
lastStatusChangeOrderByEnumTimestamp of the most recent change to isEnabled. Read-only.
nameOrderByEnumDisplay name of the email sequence.
ownerIdOrderByEnumId of the email sequence owner.
typeOrderByEnumProcess category of the sequence (e.g. EmailSequence vs other process types).
statusOrderByEnumEffective status of the sequence (e.g. Scheduled, Running, Expired, Error). Read-only; derived from the active-from / active-to settings and the most recent activity log status.
lastEmailSequenceRunOrderByEnumTimestamp the sequence last produced a run (delivered or attempted a step).
clickRateOrderByEnumFraction of delivered emails (0–1) where at least one tracked link was clicked.
bounceRateOrderByEnumFraction of sent emails (0–1) that bounced (the recipient mailserver rejected them).
openRateOrderByEnumFraction of delivered emails (0–1) that recorded at least one open event.
replyRateOrderByEnumFraction of delivered emails (0–1) where the recipient replied.
unsubscribeRateOrderByEnumFraction of delivered emails (0–1) where the recipient unsubscribed.
createdCountOrderByEnumTotal number of emails produced (queued) by the sequence across all steps.
sentCountOrderByEnumTotal number of emails actually delivered by the sequence across all steps.
enrollCountOrderByEnumNumber of records (Accounts/Contacts/Leads/Opportunities) currently enrolled in this sequence.
solutionsOrderByEnumNames of the solutions whose canvas contains this sequence, in name order. Empty when the sequence is on no solution canvas.
triggerEntityNameOrderByEnumEntity name whose records trigger automatic enrollment into this sequence (e.g. "Lead", "Contact"). Empty when the sequence is manually enrolled only.
triggerFieldIdOrderByEnumId of the field on the trigger entity whose value change drives enrollment (e.g. a step field on a Lead). Empty when no field-based trigger is configured.
stepCountOrderByEnumNumber of steps configured in the sequence.
CreateEmailSequenceInput input 9 fields: clientMutationId, modified, created, …

Field values of a new EmailSequence record.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
descriptionStringFree-form description of the sequence.
nameString!Display name of the email sequence.
ownerIdID!Id of the email sequence owner.
settingsEmailSequenceSchemaJSONStringJSON schema describing the sequence trigger, nodes (steps) and global actions (e.g. on-reply, on-bounce, on-unsubscribe). This payload conforms to the EmailSequenceSchema JSON Schema: GET /api/v100/rest/schemas/EmailSequenceSchema.json on your region's API host
typeProcessTypeEnum!Process category of the sequence (e.g. EmailSequence vs other process types).
documents[CreateCloudObjectRelationNoBackrefInput!]Attachments and other documents linked to this sequence.
CreateOrUpdateEmailSequenceInput input 10 fields: clientMutationId, id, modified, …

Field values of an EmailSequence record to create, or to update when its id is set.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idIDUnique identifier of entity.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
descriptionStringFree-form description of the sequence.
nameStringDisplay name of the email sequence.
ownerIdIDId of the email sequence owner.
settingsEmailSequenceSchemaJSONStringJSON schema describing the sequence trigger, nodes (steps) and global actions (e.g. on-reply, on-bounce, on-unsubscribe). This payload conforms to the EmailSequenceSchema JSON Schema: GET /api/v100/rest/schemas/EmailSequenceSchema.json on your region's API host
typeProcessTypeEnumProcess category of the sequence (e.g. EmailSequence vs other process types).
documents[CreateCloudObjectRelationNoBackrefInput!]Attachments and other documents linked to this sequence.
DeleteEmailSequenceInput input clientMutationId: String, id: ID!

Id of the EmailSequence record to delete.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idID!Unique identifier of entity.
DisplayColumnParams input fieldId: ID!, displayOption: DisplayOption!

Column requested from a record list: the field and the form in which its value is returned.

Input fieldTypeDescription
fieldIdID!Id of the field shown in the column.
displayOptionDisplayOption!Form in which the column value is returned, for example as a readable name or as the raw stored value.
EmailSequenceTabDataGridViewOptionsParams input 5 fields: filterByOwnerId, showActive, showInactive, …

Options that narrow a list of email sequences by owner, active state, status and tags.

Input fieldTypeDescription
filterByOwnerId[ID!]Ids of the owners whose records are listed; null or an empty list turns the owner filter off.
showActiveBoolean!When true, the list includes active records. When both showActive and showInactive are false, the list is not filtered by state.
showInactiveBoolean!When true, the list includes inactive records; see showActive.
filterByStatus[ProcessStatusEnum!]Statuses to include, such as Ok, Warning or Error; null or an empty list turns the status filter off. Ignored when both showActive and showInactive are false.
filterByTagIds[ID!]Ids of tags; only records with at least one of them are listed. Null or an empty list turns the tag filter off. Only processes can be tagged, so for approval processes and email sequences any tag id returns an empty list.
GridHighlightChangesParams input 5 fields: period, columns, showOnlyRecordsWithChanges, …

Settings for highlighting recent changes in a record grid: the look-back period, the columns watched and whether only changed records are listed.

Input fieldTypeDescription
periodHighlightPeriodEnum!Look-back window in which changes are highlighted; with Custom, customPeriodValue gives the number of days.
columns[UUID!]Ids of the displayed fields whose changes are highlighted. Null highlights all displayed fields; an empty list turns highlighting off.
showOnlyRecordsWithChangesBoolean!When true, only records with a highlighted change are listed.
customPeriodValueIntNumber of days to look back when period is Custom.
isEnabledBooleanWhen true, changes are highlighted. Defaults to false, which turns highlighting off.
UpdateEmailSequenceInput input 10 fields: clientMutationId, id, modified, …

Id of an EmailSequence record and the field values to change.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idID!Unique identifier of entity.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
descriptionStringFree-form description of the sequence.
nameStringDisplay name of the email sequence.
ownerIdIDId of the email sequence owner.
settingsEmailSequenceSchemaJSONStringJSON schema describing the sequence trigger, nodes (steps) and global actions (e.g. on-reply, on-bounce, on-unsubscribe). This payload conforms to the EmailSequenceSchema JSON Schema: GET /api/v100/rest/schemas/EmailSequenceSchema.json on your region's API host
typeProcessTypeEnumProcess category of the sequence (e.g. EmailSequence vs other process types).
documents[CreateCloudObjectRelationNoBackrefInput!]Attachments and other documents linked to this sequence.
BulkUpdateEmailSequencePayload object result: BulkUpdateResults!

Result of the bulkUpdateEmailSequence mutation.

FieldTypeDescription
resultBulkUpdateResults!Ids of the created, updated and deleted records, and the items that failed.
CreateEmailSequencePayload object emailSequence: EmailSequenceEntity, clientMutationId: String

Result of the createEmailSequence mutation.

FieldTypeDescription
emailSequenceEmailSequenceEntityThe created record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
DeleteEmailSequencePayload object emailSequence: EmailSequenceEntity, clientMutationId: String

Result of the deleteEmailSequence mutation.

FieldTypeDescription
emailSequenceEmailSequenceEntityThe deleted record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
UpdateEmailSequencePayload object emailSequence: EmailSequenceEntity, clientMutationId: String

Result of the updateEmailSequence mutation.

FieldTypeDescription
emailSequenceEmailSequenceEntityThe updated record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
ChangeLogAccountClassValue object accountClassValue: AccountClassEnum!

Value of an account class field before or after a change.

FieldTypeDescription
accountClassValueAccountClassEnum!Account class the field held before or after the change.
ChangeLogAttendeeEmailsValue object emails: [String]!

Value of an appointment attendee email field as recorded in a change log entry.

FieldTypeDescription
emails[String]!Email addresses of the attendees in the field value.
ChangeLogBooleanValue object booleanValue: Boolean!

Value of a true/false field before or after a change.

FieldTypeDescription
booleanValueBoolean!True/false value of the field.
ChangeLogDatetimeValue object datetimeValue: DateTime!

Value of a date and time field before or after a change.

FieldTypeDescription
datetimeValueDateTime!Date and time value of the field, in the requesting user's time zone.
ChangeLogDateValue object dateValue: Date!

Value of a date field before or after a change.

FieldTypeDescription
dateValueDate!Date the field held before or after the change, without a time part.
ChangeLogDropdownValue object id: ID!, label: String!

Option selected in a dropdown or checkbox field value recorded in a change.

FieldTypeDescription
idID!Id of the selected option.
labelString!Current name of the selected option.
ChangeLogEntityListValue object values: [ChangeLogEntityListValueItem!]!

Records referenced by a field that links several records, such as linked records or watchers, before or after a change.

FieldTypeDescription
values[ChangeLogEntityListValueItem!]!Records referenced by the field value, such as the related records of a lookup, linked-records, products or watchers field.
ChangeLogEntityListValueItem object id: ID!, label: String!, entityName: EntityNameEnum!, entityApiName: String

Record referenced by a field value recorded in a change.

FieldTypeDescription
idID!Id of the referenced record.
labelString!Current name of the referenced record.
entityNameEntityNameEnum!Type of the referenced record; CustomEntity for a custom entity record.
entityApiNameStringAPI name of the custom entity when entityName is CustomEntity; null otherwise.
ChangeLogFloatValue object floatValue: Float!

Value of a decimal-number field before or after a change.

FieldTypeDescription
floatValueFloat!Decimal value of the field.
ChangeLogForeignCurrencyValue object baseValue: Float!, valueForeign: Float!, symbol: String!, currencyId: ID!

Amount of a foreign-currency field before or after a change, in its own currency and in the base currency of the space.

FieldTypeDescription
baseValueFloat!Amount converted to the base currency of the space.
valueForeignFloat!Amount in the currency given by currencyId.
symbolString!Symbol of the currency given by currencyId.
currencyIdID!Id of the currency the amount was entered in.
ChangeLogGenderValue object genderValue: GenderEnum!

Value of a gender field before or after a change.

FieldTypeDescription
genderValueGenderEnum!Gender the field held before or after the change.
ChangeLogGeoLocationValue object formatted: String!, lat: Float!, lng: Float!

Coordinates of a geographic location field before or after a change.

FieldTypeDescription
formattedString!Location written as degrees, minutes and seconds.
latFloat!Latitude in decimal degrees.
lngFloat!Longitude in decimal degrees.
ChangeLogIntValue object intValue: Int!

Value of a whole-number field before or after a change.

FieldTypeDescription
intValueInt!Whole-number value of the field.
ChangeLogLabelFlagValue object flagValue: Int!

Label flags (priority, hot, stalled) of a record before or after a change.

FieldTypeDescription
flagValueInt!Flags of the field value as a bit mask: Priority = 1, Hot = 2, Stalled = 4.
ChangeLogLeadStatusValue object leadStatusValue: LeadStatusEnum!

Status of a lead before or after a change.

FieldTypeDescription
leadStatusValueLeadStatusEnum!Lead status the field held before or after the change.
ChangeLogMeetingValue object joinUrl: String!, type: AppointmentMeetingTypeEnum!

Online meeting of an appointment before or after a change.

FieldTypeDescription
joinUrlString!Link participants use to join the online meeting.
typeAppointmentMeetingTypeEnum!Online meeting service hosting the meeting.
ChangeLogMultiCheckboxValue object values: [ChangeLogDropdownValue!]!

Options selected in a multi-select checkbox field before or after a change.

FieldTypeDescription
values[ChangeLogDropdownValue!]!Options selected in the field value.
ChangeLogOpptyStatusValue object opptyStatusValue: OpptyStatusEnum!

Status of an opportunity before or after a change.

FieldTypeDescription
opptyStatusValueOpptyStatusEnum!Opportunity status the field held before or after the change.
ChangeLogPriorityValue object priorityValue: PriorityEnum!

Value of a priority field before or after a change.

FieldTypeDescription
priorityValuePriorityEnum!Priority the field held before or after the change.
ChangeLogQuoteStatusValue object quoteStatusValue: QuoteStatusEnum!

Status of a quote before or after a change.

FieldTypeDescription
quoteStatusValueQuoteStatusEnum!Quote status the field held before or after the change.
ChangeLogShareModeValue object shareModeValue: ShareModeEnum!

Sharing mode of a record before or after a change.

FieldTypeDescription
shareModeValueShareModeEnum!Sharing mode the field held before or after the change.
ChangeLogStringValue object stringValue: String!

Value of a text field before or after a change.

FieldTypeDescription
stringValueString!Text value of the field.
ChangeLogTagsValue object values: [ChangeLogTagsValueItem!]!

Tags of a tags field before or after a change.

FieldTypeDescription
values[ChangeLogTagsValueItem!]!Tags in the field value.
ChangeLogTagsValueItem object id: ID!, label: String!, color: Int!

Tag in a tags field value recorded in a change.

FieldTypeDescription
idID!Id of the tag.
labelString!Current name of the tag.
colorInt!Display color of the tag, encoded as a 24-bit RGB integer.
ChangeLogTaskStatusValue object taskStatusValue: TaskStatusEnum!

Status of a task before or after a change.

FieldTypeDescription
taskStatusValueTaskStatusEnum!Task status the field held before or after the change.
ChangeLogUuidValue object id: ID!, label: String!

Record referenced by a single-record field before or after a change.

FieldTypeDescription
idID!Id of the referenced record.
labelString!Current name of the referenced record.
ChangeLogValueObject union ChangeLogStringValue | ChangeLogIntValue | ChangeLogFloatValue | ChangeLogBooleanValue | ChangeLogDateValue | ChangeLogDatetimeValue | ChangeLogDropdownValue | ChangeLogForeignCurrencyValue | ChangeLogMultiCheckboxValue | ChangeLogEntityListValue | ChangeLogUuidValue | ChangeLogGenderValue | ChangeLogLabelFlagValue | ChangeLogPriorityValue | ChangeLogAccountClassValue | ChangeLogShareModeValue | ChangeLogTaskStatusValue | ChangeLogLeadStatusValue | ChangeLogOpptyStatusValue | ChangeLogMeetingValue | ChangeLogTagsValue | ChangeLogAttendeeEmailsValue | ChangeLogQuoteStatusValue | ChangeLogGeoLocationValue

Value of a field before or after a change; the variant matches the kind of field, such as text, number, date, option, record reference or currency amount.

DataGridChange object 5 fields: newValue, oldValue, applicationId, …

Most recent change of a field value in a record grid within the highlight period: the old and new value, when it changed, by whom and through which application.

FieldTypeDescription
newValueChangeLogValueObjectValue of the field after its most recent change in the highlight period.
oldValueChangeLogValueObjectValue of the field before that change.
applicationIdUUID!Id of the application through which the change was made.
createdDateTime!Date and time of the change.
userIdIntNumeric account id of the user who made the change; it differs from the user id used on space records.
DataGridViewItem object id: ID!, data: [FieldDataContainer!]!

Row of a record grid: the record id and the values of the requested columns.

FieldTypeDescription
idID!Id of the record shown in the row.
data[FieldDataContainer!]!Values of the row, one per requested display column.
DisplayOption enum Natural, AsIs, AsPicture, AsNumeric, Mixed, AsEntityType, … (9 values)

Form in which a field value is returned, for example as a readable name or as the raw stored value.

ValueDescription
NaturalReadable display value; for references, the name of the related record.
AsIsRaw stored value, such as the ID of a related record.
AsPictureURL of the related record's picture.
AsNumericNumeric value suitable for calculations.
MixedObject containing the value in several display forms, keyed by display option.
AsEntityTypeRecord type of the related record.
CustomA specific field of the related record, such as a currency code, instead of its default display value; chosen by the server.
CompactViewText of the related record's compact view.
RollupRawDataStructured raw data of complex fields (for example pipeline, days in step or social profiles); same as Natural for other fields.
EmailSequenceCountStats interface 5 fields: openCount, clickCount, replyCount, …

Email counts of an email sequence: how many of its emails were sent, opened, clicked, replied to or used to unsubscribe.

FieldTypeDescription
openCountInt!Number of sent emails that were opened at least once.
clickCountInt!Number of sent emails in which at least one link was clicked.
replyCountInt!Number of sent emails that received a reply.
unsubscribeCountInt!Number of sent emails through which the recipient unsubscribed.
sentCountInt!Number of emails sent.
EmailSequenceCreateRecordNode object 5 fields: id, condition, dayOffset, …

Email sequence step that creates a record, such as a task, for the enrolled record.

FieldTypeDescription
idUUID!Unique identifier of this step within the sequence.
conditionEmailSequenceNodeCondition!Condition that decides whether this step runs or the enrollment ends.
dayOffsetInt!Number of days to wait before this step runs, counted from the previous step (or from enrollment for the first step).
entityProcessEntityTemplateTemplate describing the record to create when this step runs, including the field values to set.
entityTypeEntityNameEnum!Type of record created by this step. Currently only Task is supported.
EmailSequenceDeactivationReasonEnum enum NoReason, Manual, TooManyErrors, DisabledFeature

Why an email sequence is currently disabled.

ValueDescription
NoReasonThe sequence is enabled.
ManualA user disabled the sequence.
TooManyErrorsThe sequence was suspended automatically after repeated failed runs.
DisabledFeatureThe sequence was suspended because the feature is no longer available in the space.
EmailSequenceFilter object filterMainBox: MainFilterBox!, filterSiblingBoxes: [FilterBox!]!, operator: FilterGroupOperator!, formula: String

Field conditions an email sequence checks against an enrolled record.

FieldTypeDescription
filterMainBoxMainFilterBox!Primary group of field conditions evaluated against the record.
filterSiblingBoxes[FilterBox!]!Additional condition groups combined with the main group to form the complete filter.
operatorFilterGroupOperator!Logical operator (AND or OR) that joins the condition groups when no explicit formula is given.
formulaStringOptional boolean expression referencing the condition groups by number to combine them in a custom way.
EmailSequenceGlobalActionsSettings object 19 fields: onReply, onReplyUnenroll, onReplySendEmail, …

Sequence-wide reactions of an email sequence to replies, unsubscribes and custom conditions, such as ending the enrollment or sending an email.

FieldTypeDescription
onReplyBoolean!When true, the sequence reacts when a recipient replies to one of its emails.
onReplyUnenrollBoolean!When true, a recipient who replies is removed from the sequence.
onReplySendEmailBoolean!When true, an email is sent in response to a reply.
onReplyEmailEmailSequenceNodeEmailEmail sent in response to a reply.
onReplyCreateEntityBoolean!When true, a record is created in response to a reply.
onReplyEntityProcessEntityTemplateTemplate for the record created in response to a reply.
onUnsubscribeBoolean!When true, the sequence reacts when a recipient unsubscribes, removing them from the sequence.
onUnsubscribeCreateEntityBoolean!When true, a record is created when a recipient unsubscribes.
onUnsubscribeEntityProcessEntityTemplateTemplate for the record created when a recipient unsubscribes.
onConditionBoolean!When true, the sequence evaluates the custom condition filter and acts when it matches.
onConditionFilterEmailSequenceFilter!Field-based filter that defines the custom condition checked against the enrolled record.
onConditionUnenrollBoolean!When true, a record matching the custom condition is removed from the sequence.
onConditionSendEmailBoolean!When true, an email is sent when the custom condition matches.
onConditionEmailEmailSequenceNodeEmailEmail sent when the custom condition matches.
onConditionCreateEntityBoolean!When true, a record is created when the custom condition matches.
onConditionEntityProcessEntityTemplateTemplate for the record created when the custom condition matches.
onBounceBoolean!When true, the sequence reacts when one of its emails bounces.
onBounceUnenrollBoolean!When true, a recipient whose email bounces is removed from the sequence.
onBounceUnsubscribeBoolean!When true, a recipient whose email bounces is also marked as unsubscribed.
EmailSequenceNode interface id: UUID!, condition: EmailSequenceNodeCondition!, dayOffset: Int!

Step of an email sequence: sends an email or creates a record a set number of days after the previous step, when its condition holds.

FieldTypeDescription
idUUID!Unique identifier of this step within the sequence.
conditionEmailSequenceNodeCondition!Condition that decides whether this step runs or the enrollment ends.
dayOffsetInt!Number of days to wait before this step runs, counted from the previous step (or from enrollment for the first step).
EmailSequenceNodeCondition object action: EmailSequenceNodeConditionActionEnum!, filter: EmailSequenceFilter!

Condition a step of an email sequence checks before it runs, such as no reply to the previous email; when it fails, the enrollment ends.

FieldTypeDescription
actionEmailSequenceNodeConditionActionEnum!Condition that must hold for the step to run. Always runs unconditionally; NotOpen, NoClick, and NoReply check whether the previous email was opened, clicked, or replied to; TaskCompleted, TaskNotCompleted, and TaskNotUpdated check the previous task; Custom evaluates the filter.
filterEmailSequenceFilter!Field-based filter evaluated against the record when the action is Custom.
EmailSequenceNodeConditionActionEnum enum Always, NotOpen, NoClick, NoReply, TaskNotUpdated, TaskNotCompleted, TaskCompleted, Custom

Condition a sequence step checks against the previous step before it runs; when it fails, the recipient leaves the sequence.

ValueDescription
AlwaysThe step always runs; required for the first step.
NotOpenRuns only if the previous email was not opened.
NoClickRuns only if no link in the previous email was clicked.
NoReplyRuns only if the previous email was not replied to.
TaskNotUpdatedRuns only if the task created by the previous step has not been modified.
TaskNotCompletedRuns only if the task created by the previous step is not completed.
TaskCompletedRuns only if the task created by the previous step is completed.
CustomRuns only if the previous step's email or task matches the custom filter.
EmailSequencePeriodStats object 8 fields: openCount, clickCount, replyCount, …

Statistics of an email sequence for one period of its timeline.

FieldTypeDescription
openCountInt!Number of sent emails that were opened at least once.
clickCountInt!Number of sent emails in which at least one link was clicked.
replyCountInt!Number of sent emails that received a reply.
unsubscribeCountInt!Number of sent emails through which the recipient unsubscribed.
sentCountInt!Number of emails sent.
createCountInt!Number of tasks, leads and text messages created in the period.
enrollCountInt!Number of records enrolled in the period.
dateDate!Date of the first activity in the period.
EmailSequenceSchema object trigger: EmailSequenceTrigger!, nodes: [EmailSequenceNode!]!, settings: EmailSequenceSettings!

Definition of an email sequence: the records it enrolls, the steps it runs and its sending settings.

FieldTypeDescription
triggerEmailSequenceTrigger!Defines which record type and email field enroll into the sequence.
nodes[EmailSequenceNode!]!Ordered steps of the sequence, each sending an email or creating a record subject to its condition and day offset.
settingsEmailSequenceSettings!Scheduling window, time zone, global actions, and lifecycle options for the sequence.
EmailSequenceSendEmailNode object id: UUID!, condition: EmailSequenceNodeCondition!, dayOffset: Int!, email: EmailSequenceNodeEmail!

Email sequence step that sends an email.

FieldTypeDescription
idUUID!Unique identifier of this step within the sequence.
conditionEmailSequenceNodeCondition!Condition that decides whether this step runs or the enrollment ends.
dayOffsetInt!Number of days to wait before this step runs, counted from the previous step (or from enrollment for the first step).
emailEmailSequenceNodeEmail!Email message this step sends, including recipients, content, and sender.
EmailSequenceSettings object 11 fields: globalActions, timezone, dayOfWeek, …

Sending window, time zone, active period and sequence-wide reactions of an email sequence.

FieldTypeDescription
globalActionsEmailSequenceGlobalActionsSettings!Sequence-wide reactions to recipient replies, unsubscribes, bounces, and custom conditions.
timezoneString!IANA time-zone name (for example Europe/Bratislava) in which the sending window and active dates are interpreted.
dayOfWeek[Int!]!Weekdays on which emails may be sent, given as numbers 1 (Monday) through 7 (Sunday).
fromTimeOfDayInt!Start of the daily sending window, expressed as minutes after midnight (0-1440).
toTimeOfDayInt!End of the daily sending window, expressed as minutes after midnight (0-1440); must be greater than fromTimeOfDay.
everyEmailStartsConversationBoolean!When true, each email starts its own conversation thread; when false, all emails of one enrollment share a single thread.
triggerProcessBooleanWhen true, the sequence starts the process given by triggerProcessId for records it creates.
triggerProcessIdUUIDIdentifier of the process to start when triggerProcess is enabled.
activeFromDateDate from which the sequence is allowed to send; earlier scheduling waits until this date.
activeToDateDate after which the sequence stops sending.
autoUnenrollWhenExpiredBooleanWhen true, records still enrolled after activeTo passes are automatically removed from the sequence.
EmailSequenceStats object 27 fields: openCount, clickCount, replyCount, …

Statistics of an email sequence for a period: enrollments, sent emails with their opens, clicks and replies, and the records it created.

FieldTypeDescription
openCountInt!Number of sent emails that were opened at least once.
clickCountInt!Number of sent emails in which at least one link was clicked.
replyCountInt!Number of sent emails that received a reply.
unsubscribeCountInt!Number of sent emails through which the recipient unsubscribed.
sentCountInt!Number of emails sent.
createTaskCountInt!Number of tasks created by the sequence steps.
createLeadCountInt!Number of leads created by the sequence steps.
createTextCountInt!Number of text messages sent by the sequence steps.
createTaskRecipientsCountInt!Number of enrolled records for which the sequence created at least one task.
createLeadRecipientsCountInt!Number of enrolled records for which the sequence created at least one lead.
createTextRecipientsCountInt!Number of enrolled records the sequence sent at least one text message to.
currentEnrollCountInt!Number of enrollments that are still running.
unenrollCountInt!Number of enrollments that ended because the record was unenrolled.
sentRecipientsCountInt!Number of enrolled records the sequence sent at least one email to.
notOpenRecipientsCountInt!Number of enrolled records that were sent emails but opened none of them.
openRecipientsCountInt!Number of enrolled records that opened at least one email.
clickRecipientsCountInt!Number of enrolled records that clicked a link in an email.
replyRecipientsCountInt!Number of enrolled records that replied to at least one email.
bounceRecipientsCountInt!Number of enrolled records with at least one bounced email.
notOpenCountInt!Number of sent emails that were not opened.
enrollCountInt!Number of enrollments.
bounceCountInt!Number of sent emails that bounced.
steps[EmailSequenceStepStats!]!Statistics of each step, in step order. They count only activity since the step statistics were last reset.
recipientsGenericDrilldownDataGridViewItems (10 args)Records behind one of the counts, chosen by type, as a list view. Empty for a sequence without settings.
createdTasksGenericDrilldownDataGridViewItems! (9 args)Tasks created by the sequence, as a list view.
createdLeadsGenericDrilldownDataGridViewItems! (9 args)Leads created by the sequence, as a list view.
timeline[EmailSequencePeriodStats!]! (1 args)Statistics over time, one item per period with activity, oldest first.
EmailSequenceStatsPeriodEnum enum All, Last7Days, Last30Days, Last90Days, LastYear

Time window for email sequence statistics.

ValueDescription
AllThe whole history of the sequence.
Last7DaysThe last 7 days.
Last30DaysThe last 30 days.
Last90DaysThe last 90 days.
LastYearThe last 12 months.
EmailSequenceStatsRecipientTypeEnum enum Enroll, CurrentEnroll, Unenroll, Unsubscribe, Sent, Open, … (13 values)

Group of email sequence recipients to list in the sequence statistics drill-down.

ValueDescription
EnrollAll records ever enrolled in the sequence.
CurrentEnrollRecords that are still running through the sequence.
UnenrollRecords that were unenrolled before the sequence finished.
UnsubscribeRecipients who unsubscribed through a sequence email.
SentRecipients who were sent at least one sequence email.
OpenRecipients who opened a sequence email.
NotOpenRecipients who were sent a sequence email but opened none.
ClickRecipients who clicked a link in a sequence email.
ReplyRecipients who replied to a sequence email.
BounceRecipients whose sequence email bounced.
CreateTaskRecipients for whom a sequence step created a task.
CreateLeadRecipients for whom a sequence step created a lead.
CreateTextRecipients for whom a sequence step created a text message.
EmailSequenceStepStats object 10 fields: openCount, clickCount, replyCount, …

Statistics of one step of an email sequence.

FieldTypeDescription
openCountInt!Number of sent emails that were opened at least once.
clickCountInt!Number of sent emails in which at least one link was clicked.
replyCountInt!Number of sent emails that received a reply.
unsubscribeCountInt!Number of sent emails through which the recipient unsubscribed.
sentCountInt!Number of emails sent.
stepEmailSequenceNode!Sequence step these statistics belong to.
emailTemplateEmailTemplateEntityEmail template the step sends; empty when the step sends no email from a template.
conversionIntShare, in percent, of this step's emails and created records that the next step followed up on. Empty for the last step.
createCountInt!Number of tasks, leads and text messages the step created.
bounceCountInt!Number of emails sent by the step that bounced.
EmailSequenceTimelinePeriodEnum enum Daily, Weekly, Monthly, Quarterly, Yearly

Time bucket used to group email sequence statistics in the timeline.

ValueDescription
DailyOne data point per day.
WeeklyOne data point per week.
MonthlyOne data point per month.
QuarterlyOne data point per quarter.
YearlyOne data point per year.
EmailSequenceTrigger object entityType: EntityNameEnum!, fieldId: ID!, entityApiName: String, relationLookupFieldId: ID

Record type an email sequence enrolls and the email field whose address its emails are sent to.

FieldTypeDescription
entityTypeEntityNameEnum!Type of record that enrolls into the sequence when the trigger fires, such as Contact, Account, Lead, Opportunity, or Project.
fieldIdID!Identifier of the email field on the trigger record whose address the sequence sends to.
entityApiNameStringAPI name of the trigger record type when it is a custom entity.
relationLookupFieldIdIDIdentifier of a relation field used to resolve the email recipient from a related record rather than the trigger record itself.
FieldDataContainer object value: JSONString, fieldId: ID!, displayOption: DisplayOption!, change: DataGridChange

Value of one field in a row of a data grid view.

FieldTypeDescription
valueJSONStringValue of the field in the form given by displayOption.
fieldIdID!Id of the field the value belongs to.
displayOptionDisplayOption!Form in which the value is returned.
changeDataGridChangeMost recent change of the value when the view highlights changes; null otherwise.
GenericDrilldownDataGridViewItems object 5 fields: total, sessionId, items, …

Scrollable list of the records behind a chart, grid or statistic, as rows with the requested columns, plus sums and averages of the numeric columns.

FieldTypeDescription
totalInt!Total number of results in the view
sessionIdString!Session that identifies consistent snapshot of the view data used for scrolling
items[DataGridViewItem!]!Rows of the requested page, one per record, with the values of the requested columns.
sumItem[FieldDataContainer!]!Sum of each numeric column over all listed records, one value per field.
averageItem[FieldDataContainer!]!Average of each numeric column over all listed records, one value per field; empty values count as zero.
HighlightPeriodEnum enum Last7Days, Last14Days, Last30Days, Last3Months, Last6Months, LastYear, Custom

Look-back window used to highlight records or values that changed recently.

ValueDescription
Last7DaysChanges in the last 7 days.
Last14DaysChanges in the last 14 days.
Last30DaysChanges in the last 30 days.
Last3MonthsChanges in the last 3 months.
Last6MonthsChanges in the last 6 months.
LastYearChanges in the last 12 months.
CustomChanges in the last number of days set by customPeriodValue.
ListingViewInterface interface total: Int!

Scrollable list of records, with the total number of results.

FieldTypeDescription
totalInt!Total number of results in the view
SnapshotIndexedDataInterface interface sessionId: String!, total: Int!, items: [ViewItemInterface!]!

Rows of a scrollable view, addressed by their position within a consistent snapshot of the data.

FieldTypeDescription
sessionIdString!Session that identifies consistent snapshot of the view data used for scrolling
totalInt!Total number of results in the view
items[ViewItemInterface!]!Row items of scrollable view indexed by number
ViewItemInterface interface id: ID!

Row of a scrollable record list, identified by the record id.

FieldTypeDescription
idID!Id of the record shown in the row.