Newer Version Available

This content describes an older version of this product. View Latest

FlowRecord

Represents the details of a flow. This object is available in API version 58.0 and later.

Supported Calls

delete(), query(), update()

Special Access Rules

This object is available only in Salesforce Starter edition.

Fields

Field Name Details
AssociatedRecordId
Type
text
Properties
Filter, Group, Nillable, Sort, Update
Description
The ID of the record the flow is associated with.
Description
Type
text
Properties
Filter, Group, Sort
Description
The description of the flow.
ErrorCode
Type
text
Properties
Filter, Group, Nillable, Sort
Description
The error code if the flow element run encountered an error. This field is available in API version 59.0 and later. Valid values are:
  • ACTIVATING_USER_ACCOUNT_DEACTIVATED— We can't run this flow because the user who activated it has a deactivated user record.
  • ACTIVATING_USER_LOST_PERMISSIONS— We can't run this flow because the user that activated it no longer has permission to it.
  • CANNOT_PUBLISH_SEGMENT— We can't run this flow because we can't publish the segment it's using. Contact Salesforce Customer Support and ask for help with the error ID.
  • CANNOT_QUERY_SEGMENT_MEMBER_DATA— We can't run this flow because we can't query the segment membership data it's using. Contact Salesforce Customer Support and ask for help with the error ID.
  • CANNOT_REFRESH_DATA_STREAM— We can't run this flow because we can't refresh your data stream metadata. Contact Salesforce Customer Support and ask for help with the error ID.
  • CANNOT_REFRESH_IDENTITY_RES_DATA— We can't run this flow because we can't refresh your identity resolution data. Contact Salesforce Customer Support and ask for help with the error ID.
  • CANNOT_REFRESH_IDENTITY_RES_METADATA— We can't run this flow because we can't refresh your identity resolution metadata. Contact Salesforce Customer Support and ask for help with the error ID.
  • CANNOT_UPDATE_DATASTREAM_METADATA— We can't run this flow because we can't update your DataStream metadata. Contact Salesforce Customer Support and ask for help with the error ID.
  • DATA_ACTION_STATUS_ERROR— We can’t run this flow because we couldn’t create the data action. To try again, save and activate a new version of the flow.
  • FLOW_FAILED_TO_START— This flow failed to start. Contact Salesforce Customer Support and ask for help with the error ID.
ErrorDetails
Type
text
Properties
Filter, Group, Nillable, Sort
Description
The error ID. This field is available in API version 59.0 and later.
FlowDefinition
Type
text
Properties
Filter, Group, Sort
Description
Represents the flow definition.
Id
Type
text
Properties
Filter, Group, Sort
Description
The ID of the flow.
Name
Type
text
Properties
Filter, Group, Sort
Description
The label of the flow.
ProgressStatus
Type
enum
Properties
Filter, Group, Sort
Description
The progress status of the flow. Valid values are:
  • Canceled— Indicates a flow that has been deactivated by a user who doesn’t process previously added records. No additional records are added to this flow.
  • Completed— Indicates a flow that is complete. No additional records are eligible to be processed in this flow.
  • Draft— Indicates a flow that is under construction and isn’t active yet. This status can be invalid because it needs additional information before it can be activated by the user.
  • Error— Indicates a flow that has been deactivated because it encountered an error. When the error occurs, the error details are emailed to up to 5 users with the Manage Flows permission who most recently logged into Salesforce.
  • Finishing— Indicates a flow that has been deactivated by a user, but is finishing previously added records that are eligible to run to completion. No additional records are added to this flow.
  • InProgress— Indicates a flow that is running or ready to run.
  • PreparingData— Indicates a flow that is preparing the necessary data to run. This process can take up to 2 hours.
  • Scheduled— Indicates a flow scheduled to start on the date and time selected by the user.
ScheduledStartDate
Type
dateTime
Properties
Filter, Group, Sort
Description
The date and time that the flow is scheduled to start.
Segment
Type
text
Properties
Filter, Group, Sort
Description
The ID of the segment used in the flow.
Type
Type
enum
Properties
Filter, Group, Sort
Description
The trigger type of the flow. The only valid value is:
  • Segment— Refers to a segment-based flow.