ApprovalSubmission

Represents the instance of an approval request that's submitted for a record of the related object. This object is available in API version 62.0 and later.

Supported Calls

describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

Special Access Rules

This object is available for users with a Salesforce user license of type Salesforce in Enterprise, Unlimited, and Developer Editions.

Fields

Field	Details
Comments	Type textarea Properties Nillable Description The comments about the request that's submitted for approval.
DoesSendApprovalEmail	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Required. Indicates whether approval request emails are sent to approvers and delegates (`true`) or not (`false`). The default value is `false`.
FlowOrchestrationInstanceId	Type reference Properties Filter, Group, Nillable, Sort Description The ID of the flow orchestration instance record that's associated with the approval. This field is a relationship field. Relationship Name FlowOrchestrationInstance Refers To FlowOrchestrationInstance
IsEligibleForSmartApproval	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the approval submission is eligible for smart approval (`true`) or not (`false`). The default value is `false`. This field is only available with Advanced Approvals enabled.
IsSmartApprovalRun	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether this approval submission either is run in smart approval mode (`true`) or not (`false`). The default value is `false`. This field is only available with Advanced Approvals enabled.
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The sequentially-generated name of the approval submission record, for example AS-000000001.
OwnerId	Type reference Properties Filter, Group, Sort Description The ID of the user or the group that owns the approval submission record. This field is a polymorphic relationship field. Relationship Name Owner Refers To User
RelatedRecordId	Type reference Properties Filter, Group, Nillable, Sort Description Required. The API name of the related record that’s submitted for approval. Relationship Name RelatedRecord Refers To Account, AdAvailabilityViewConfig, Address, AnalyticsUserAttrFuncTkn, ApprovalSubmission, ApprovalSubmissionDetail, ApprovalWorkItem, Asset, AssetAction, AssetActionSource, AssetContractRelationship, AssetRateAdjustment, AssetRateCardEntry, AssetRelationship, AssetStatePeriod, AssociatedLocation, AsyncOperationTracker, AttrPicklistExcludedValue, AttributeAdjustmentCondition, AttributeBasedAdjRule, AttributeBasedAdjustment, AttributeCategory, AttributeCategoryAttribute, AttributeDefinition, AttributePicklist, AttributePicklistValue, AuthorizationForm, AuthorizationFormConsent, AuthorizationFormDataUse, AuthorizationFormText, BatchJob, BatchJobPart, BatchJobPartFailedRecord, BundleBasedAdjustment, BusinessBrand, Case, CaseComment, ChannelProgram, ChannelProgramLevel, ChannelProgramMember, CollaborationGroup, CommSubscription, CommSubscriptionChannelType, CommSubscriptionConsent, CommSubscriptionTiming, Contact, ContactPointAddress, ContactPointConsent, ContactPointEmail, ContactPointPhone, ContactPointTypeConsent, ContactRequest, ContextDefinitionSync, Contract, ContractItemPrice, ContractItemPriceAdjTier, CostBook, CostBookEntry, Customer, DTRecordsetReplica, DataUseLegalBasis, DataUsePurpose, DecisionTblFileImportData, DelegatedAccount, DocGenerationQueryResult, DocTemplateSectionCondition, DocumentEnvelope, DocumentGenerationProcess, DocumentRecipient, DocumentTemplate, DocumentTemplateContentDoc, DocumentTemplateSection, DocumentTemplateToken, DuplicateRecordItem, DuplicateRecordSet, EmailMessage, EngagementChannelType, ExpressionSetConstraintObj, ExternalEventMapping, FlowOrchestrationInstance, FulfillmentOrder, FulfillmentOrderItemAdjustment, FulfillmentOrderItemTax, FulfillmentOrderLineItem, GeneratedDocument, GeneratedDocumentSection, Idea, Image, Individual, IntegrationProviderDcsnRqmt, IntegrationProviderExecution, Lead, Location, LocationTrustMeasure, ManagedContentVariant, ObjectStateDefinition, ObjectStateTransition, ObjectStateValue, Obligation, Opportunity, OpportunityRelatedDeleteLog, Order, OrderAction, OrderAdjustmentGroup, OrderDeliveryGroup, OrderDeliveryMethod, OrderItem, OrderItemAdjustmentLineItem, OrderItemDetail, OrderItemRateAdjustment, OrderItemRateCardEntry, OrderItemRecipient, OrderItemRelationship, OrderItemTaxLineItem, OrgMetricScanResult, OrgMetricScanSummary, Organization, PartnerFundAllocation, PartnerFundClaim, PartnerFundRequest, PartnerMarketingBudget, PartyConsent, PriceBookEntryDerivedPrice, PriceBookRateCard, PricingAdjBatchJob, PricingAdjBatchJobLog, PricingApiExecution, PricingProcessExecution, ProcessException, Product2, ProductAttributeDefinition, ProductCatalog, ProductCategory, ProductCategoryDisqual, ProductCategoryProduct, ProductCategoryQualification, ProductClassification, ProductClassificationAttr, ProductComponentGroup, ProductComponentGrpOverride, ProductConfigFlowAssignment, ProductConfigurationFlow, ProductConfigurationRule, ProductDisqualification, ProductPriceHistoryLog, ProductPriceRange, ProductQualification, ProductRampSegment, ProductRelComponentOverride, ProductUsageGrant, ProfileSkill, ProfileSkillEndorsement, ProfileSkillUser, PromptAction, PromptError, QuickText, QuickTextUsage, Quote, QuoteLineDetail, QuoteLineItem, QuoteLineItemRecipient, QuoteLineRateAdjustment, QuoteLineRateCardEntry, RateAdjustmentByAttribute, RateAdjustmentByTier, RateCard, RateCardEntry, RatingFrequencyPolicy, SalesTransactionType, Seller, Shipment, ShipmentItem, Site, SocialPersona, SocialPost, Solution, StreamingChannel, TableauHostMapping, Topic, UnitOfMeasure, UnitOfMeasureClass, UsageGrantRenewalPolicy, UsageGrantRolloverPolicy, UsageResource, UsageResourceBillingPolicy, User, UserEsignVendorIdentifier, UserLicense, UserLocalWebServerIdentity, UserProvisioningRequest, WorkBadge, WorkBadgeDefinition, WorkOrder, WorkOrderLineItem, WorkThanks
RelatedRecordObjectName	Type string Properties Filter, Group, Nillable, Sort Description Required. The type of record that was submitted for approval.
SmartApprvlBasisSubmissionId	Type reference Properties Filter, Group, Nillable, Sort Description The approval submission on which the smart approval submission is based. This field is a relationship field. This field is only available with Advanced Approvals enabled. Relationship Name SmartApprvlBasisSubmission Refers To ApprovalSubmission
Status	Type picklist Properties Filter, Group, Restricted picklist, Sort Description Required. The status of the approval. Valid values are: `Approved` `Canceled` `Errored` `InProgress` `Recalled` `Rejected` `Suspended`
SubmittedById	Type reference Properties Filter, Group, Nillable, Sort Description Required. The ID of the user who submitted the record for approval. This field is a relationship field. Relationship Name SubmittedBy Refers To User

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.

ApprovalSubmissionShare: Sharing is available for the object.

Object Reference for the Salesforce Platform

ApprovalSubmission

Supported Calls

Special Access Rules

Fields

Associated Objects