--- schema_version: "1" id: cea76dd51fe78fd79d9a9ef91dedcb05f1016cc8235be1b66a4445c69688cf19 title: ActionCadenceStepTracker collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_actioncadencesteptracker.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_actioncadencesteptracker.htm source_site: developer.salesforce.com content_type: documentation content_hash: 13ec8c961bea88758d33f95140ac097184cfc5a25cc5911595865cf5e53f6331 description: Represents a step in an active cadence for a specific cadence target. This object is available in API version 48.0 and later. --- # ActionCadenceStepTracker Represents a step in an active cadence for a specific cadence target. This object is available in API version 48.0 and later. An ActionCadenceStepTracker record is created when a target moves to a new step in a cadence. Use ActionCadenceStepTracker to find information such as the step's current state, the reason it completed, and its type. ## Supported Calls describeSObjects(), getDeleted(), getUpdated(), query(), retrieve() ## Fields | Field | Details | | --- | --- | | ActionCadenceId | Type reference Properties Filter, Group, Nillable, Sort Description The ID of the ActionCadence that is related to the ActionCadenceStep. This field is a relationship field. Relationship Name ActionCadence Relationship Type Lookup Refers To ActionCadence | | ActionCadenceName | Type string Properties Filter, Group, Nillable, Sort Description The name of the related ActionCadence object. | | ActionCadenceStepId | Type reference Properties Filter, Group, Nillable, Sort Description ActionCadenceStepTracker is the runtime version of an ActionCadenceStep. This field contains the ID of the related ActionCadenceStep. This field is a relationship field. Relationship Name ActionCadenceStep Relationship Type Lookup Refers To ActionCadenceStep | | ActionCadenceTrackerId | Type reference Properties Filter, Group, Sort Description The ID of the related ActionCadenceTracker. This field is a relationship field. Relationship Name ActionCadenceTracker Relationship Type Lookup Refers To ActionCadenceTracker | | ActionTakenDateTime | Type dateTime Properties Filter, Nillable, Sort Description The date and time that the action described in this step was taken. | | BranchIterationCount | Type int Properties Filter, Group, Nillable, Sort Description The number of times a target has entered a specific branch within the cadence. This field is available in API version 62.0 and later. | | Channel | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The communication medium used for this step in an active cadence. This field is available in API version 62.0 and later. Possible values are: - Email | | CompletedById | Type reference Properties Filter, Group, Nillable, Sort Description The user ID of the sales rep who completed this step. A step can be assigned to several users before it’s completed. This field is available in API version 50.0 and later. This field is a relationship field. Relationship Name CompletedBy Relationship Type Lookup Refers To User | | CompletionDate | Type dateTime Properties Filter, Nillable, Sort Description The date this step completed. A step is completed either when the action is taken, or the step is skipped. | | CompletionReason | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The reason that this step completed: Possible values are: - AutomaticallyCompleted — The sales rep successfully completed this step and moved to the next one. Salesforce automatically marks this step as completed. - AutomaticallyExited — The step exited because a global exit condition occurred. This value is available in API version 49.0 and later. - ManuallyCompleted — The sales rep manually marked this step as completed. - ManuallySkipped — The sales rep skipped this step. | | DueDateTime | Type dateTime Properties Filter, Nillable, Sort Description Some steps have a due date to indicate when they must be completed. If this step has been assigned a due date, this field contains the date and time it is due. | | ErrorCode | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Possible values are: - AUTO\_EMAIL\_DAILY\_LIMIT\_REACHED - AUTO\_EMAIL\_ORG\_SETTING\_OFF - AUTO\_LIST\_MQ\_MAX\_RETRIES\_FAILED - BCC\_NOT\_ALLOWED\_IF\_BCC\_COMPLIANCE\_ENABLED - EAC\_CONFIG\_EMAIL\_CAPTURE\_OFF—Available in API version 66.0 and later. - EAC\_CONFIG\_IS\_NOT\_ACTIVE—Available in API version 66.0 and later. - EAC\_CONFIG\_LIMITED\_CAPTURE—Available in API version 66.0 and later. - EAC\_GLOBAL\_DATA\_SOURCE\_ERROR—EAC data source error - EMAIL\_ORG\_SETTING\_OFF - EXCHANGE\_MAX\_MAILBOX\_SIZE—Max Exchange mailbox size reached - EXCHANGE\_SEND\_AS\_DENIED - FETCH\_EMAIL\_THREAD\_FAILED - FIX\_WITH\_RECONNECT—Data connection failed - FROM\_ADDRESS\_FIELD\_IS\_ENCRYPTED—FromAddress field is encrypted - GOOGLE\_MAIL\_SERVICE\_NOT\_ENABLED—Gmail service not enabled - INITIAL\_OUTREACH\_ACCOUNT\_DEACTIVATED—Available in API version 66.0 and later. - INSUFFICIENT\_ACCESS\_ON\_TARGET—Available in API version 67.0 and later. - INVALID\_DRAFT—Invalid email draft - INVALID\_FROM\_ADDRESS - INVALID\_TARGET\_EMAIL - INVALID\_TEMPLATE\_ID - INVALID\_USER\_EMAIL - MAIL\_PROVIDER\_RATE\_LIMIT\_REACHED—Email provider rate limit reached - MALFORMED\_QUERY - MAX\_OUT\_EMAIL\_THREAD\_RETRY - MAX\_OUT\_LLMG\_RETRY - NON\_EMAIL\_UNKNOWN\_ERROR—Unknown error - NO\_ACTIVE\_ASDR\_AGENT - NO\_ATTACHMENT\_ACCESS - NO\_CONTENT\_VERSION\_ACCESS - NO\_LIST\_EMAIL\_PERMISSION - NO\_TARGET\_ACCESS - NO\_TOS\_SIQ - ORG\_WIDE\_AUTO\_EMAIL\_LIMIT\_REACHED - ORG\_WIDE\_DAILY\_EMAIL\_LIMIT\_REACHED - OTHER\_REQ\_FIELD\_MISSING—Other required field missing - PARDOT\_MERGE\_FIELD\_RENDERING\_ERROR - POST\_SEND\_EXCEPTION - RETRIES\_MAX\_EXCEEDED—Maximum retries exceeded - REVIEW\_CRITERIA\_FLOW\_EXECUTION\_FAILED—Available in API version 67.0 and later. - RETRY\_LATER - SCHEDULED\_EMAIL\_FAILED—Unknown error - SENDER\_MAILBOX\_NOT\_FOUND - SHARE\_LIMIT\_EXCEEDED - SOBO\_MEETING\_LINK\_GENERATION\_FAIL— Send as Seller (in Agentforce Lead Nurturing) can’t generate a meeting link. Available in API version 66.0 and later. - SOBO\_QNA\_NO\_ANSWER— Send as Seller (in Agentforce Lead Nurturing) can’t answer the prospect’s question. Available in API version 66.0 and later. - STORAGE\_LIMIT\_EXCEEDED—Available in API version 66.0 and later. - TARGET\_DO\_NOT\_CONTACT\_ON—Target has Do Not Contact on - TARGET\_EMAIL\_BOUNCED - TARGET\_EMAIL\_EMPTY - TARGET\_HAS\_INVALID\_ID - TARGET\_HAS\_OPT\_OUT\_EMAIL - TEMPLATE\_DELETED - TEMPLATE\_EMPTY—Email subject or body missing - TEMPLATE\_HAS\_INVALID\_MERGE\_FIELD - TEMPLATE\_IS\_INACTIVE - TEMPLATE\_MERGE\_FIELD\_RENDERING\_ERROR - TEMPLATE\_NOT\_PUBLIC—No access to template - TEMPLATE\_TOO\_LARGE - UNAUTHORIZED\_EMAIL\_DOMAIN—Available in API version 66.0 and later. - UNKNOWN—Email unknown error - USER\_HAS\_LOST\_HVS\_ACCESS - USER\_IS\_INACTIVE - USER\_NOT\_IN\_EAC\_CONFIG—Available in API version 66.0 and later. | | GoToStepIterationCount | Type int Properties Filter, Group, Nillable, Sort Description The number of times the action cadence step tracker was created for the same step in a cadence. Available in API version 58.0 and later. | | IsActionTaken | Type boolean Properties Defaulted on create, Filter, Group, Sort Description true if the sales rep completed an action during this step, such as making a phone call, otherwise false. The default value is false. This field is a calculated field. | | MessageType | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The type of messaging channel for this step. Available in API version 67.0 and later. Possible values are: - Text— SMS Message | | ReviewCriteriaFlowStatus | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The execution status of the flow run to evaluate if a review is required for an email. Available in API version 67.0 and later. Possible values are: - Failed - NotExecuted - Success | | ReviewDisposition | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Determines what happens to an email when review before send is enabled and the review time duration has expired. Available in API version 67.0 and later. Possible values are: - CancelOutreach - SendAnyway | | ScheduledStartDateTime | Type dateTime Properties Filter, Nillable, Sort Description The date and time when the step starts. Available in API version 58.0 and later. | | SecondsOverdue | Type int Properties Filter, Group, Nillable, Sort Description If this step has a due date that has passed, this field contains the number of seconds that has elapsed since the due date. Once a sales rep takes action on the cadence step, the value of this field is the number of seconds elapsed between the due date and the time the action was taken. This field is a calculated field. | | State | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The current state of this step. Possible values are: Possible values are: - Active— The current step that the sales rep is performing. There can only be one active step for a given target. - Approved—The step is approved. Available in API version 66.0 and later. - Cancelled—The sales rep canceled the step. Salesforce doesn’t run any canceled steps. - Completed—This step is finished. Either the work in the step completed, or the step was skipped. - Error—An error occurred while executing this step. - ExpiredApproved—The approval for this step has expired. Available in API version 67.0 and later. - InProgress—The sales rep has started the step, but it isn’t yet completed. - NeedsReview—The step needs a review. Available in API version 66.0 and later. - Paused—The sales rep paused the step. - Queued—Used for automated email steps. The email step has started but the email is waiting in the queue to be sent. - Scheduled—Used for email steps. An email can be scheduled to be sent later. | | StepTitle | Type string Properties Filter, Group, Nillable, Sort Description The name of the related step. | | StepType | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The type of step to execute. Possible values are: - AutoSendAnEmail - Branch - Copilot - CreateTask - DaisyChain - LinkedInConnection - LinkedInMail - ListenerBranch - MakeACall - PlatformScreenFlow - Root - SendAMessage - SendAnEmail - SubRoot - Terminal - Wait | | TargetId | Type reference Properties Filter, Group, Nillable, Sort Description The ID of the prospect that is assigned to this cadence. This field is a polymorphic relationship field. Relationship Name Target Relationship Type Lookup Refers To Contact, Lead | | WasEverPaused | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the sales rep had ever paused this step (true), or not (false). This field is available in API version 50.0 and later. | ## Usage List all the steps that this prospect has completed in a given cadence: select StepTitle from ActionCadenceStepTracker where TargetID = and ActionCadenceId= and StepType="Completed" ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [ActionCadenceStepTrackerChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 48.0) Change events are available for the object. #### See Also - [ActionCadence](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_actioncadence.htm "Represents the definition of a cadence. This object is available in API version 45.0 and later.") - [ActionCadenceRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_actioncadencerule.htm "Represents the logic that a branch step uses to determine which branch an action cadence tracker follows in an action cadence. Use ActionCadenceRule to learn about a branch step, including its logic and what the next step is. This object is available in API version 48.0 and later.") - [ActionCadenceStep](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_actioncadencestep.htm "Represents a step in a cadence. Use ActionCadenceStep to learn which steps belong to a cadence, and how the steps are connected to each other. This object is available in API version 48.0 and later.") - [ActionCadenceRuleCondition](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_actioncadencerulecondition.htm "Represents the logic for a branch step. This object is available in API version 48.0 and later.")