Actions Developer Guide

Introducing Actions
Action Objects
Apex Actions
Assign Enablement Program
Apply Case Classification Recommendations
B2B and D2C Commerce Actions
Cancel Approval Submission Action
Change Order Summary Preview
Change Order Summary Submit
Commerce Checkout Flow Actions
Convert Base64 Speech to Text Action
Create Service Document Actions
Create Service Report Actions
Custom Notification Actions
Deploy Data Kit Components Action
Email Alert Actions
Einstein Bots Actions
Exit Individuals from a Flow Action
Explore Conversation Actions
Flow Actions
Generate Order Summary Action
Generate Work Orders Actions
Get Assessment Response Summary
Get Conversation Intelligence Action
Get Conversation Transcript Action
Get Data Graph Data By Lookup
Get Data Graph Metadata
Knowledge Actions
Lead Action
Live Message Notification Actions
Omni-Channel Action
Apply Payment Action
Payment Sale Action
Perform Survey Sentiment Analysis
PlatformAction
Post to Chatter Actions
Preview Cart to Exchange Order
Prompt Template Actions
Quick Actions
Reassign Approval Work Item Action
Recall Approval Submission Action
Refresh Metric Actions
Review Approval Work Item Action
Sales Engagement Actions
Salesforce Omnichannel Inventory Actions
Salesforce Order Management Actions
Send Conversation Messages Actions
Send Notification Actions
Session-Based Permission Set Actions
Simple Email Actions
Speech to Text Action
Submit Exchange Order
Submit for Approval Actions
Survey Invitation Actions
Text to Speech Action (Beta)
Work Plan and Work Step Actions
PDF

Submit for Approval Actions

Submit a Salesforce record for approval if an approval process is defined for the current entity.

For more information about creating submit for approval actions, see Creating Approval Actions, and to learn more about approval processes, see Approval Process Overview, in Salesforce Help.

This object is available in API version 32.0 and later.

Supported REST HTTP Methods

URI: Get a list of actions: /services/data/vXX.X/actions/standard/submit

Formats: JSON, XML

HTTP Methods: GET, HEAD, POST

Authentication: Authorization: Bearer token

Inputs

Input Type Description
comment string Optional. Comments that accompany the Approval submission.
nextApproverIds reference Optional. An array of one ID of the next approver, which can be a user or a group. This input is optional because some approval processes have the next approver specified in the approval process definition. You can't specify more than 2,000 approvers.
objectId reference Required. The ID of the record being submitted for approval.
processDefinitionNameOrId string Optional. The ID or name of the approval process to run against the record. If none is specified, the first approval process whose entry criteria the record satisfies is used. Names can't be longer than 120 characters.
skipEntryCriteria boolean Optional. A Boolean value controlling whether the entry criteria for the specified approval process must be evaluated for the record (true) or not (false). If set to true, also specify processDefinitionNameOrId.
submitterId string Optional. The ID of the user submitting the record for approval. If none is specified, the submitter is the current user.

Outputs

Output Type Description
actorIds reference An array of the IDs of the next approvers.
entityId reference The ID of the record submitted for approval.
instanceId reference The ID of the approval process instance.
instanceStatus string The status of the approval: Approved, Pending, Rejected, or Removed.
newWorkItemIds reference An array of the IDs of the work items created for the next step in this approval process.