Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More

Considerations and Activation of "Create Audit Fields" in Salesforce

Publish Date: Jun 29, 2026
Description

What Is the Create Audit Fields Feature?

Salesforce allows system fields to be set through the API during data migration. When migrating data from an external system, the API lets you set a number of fields on objects that were previously read-only. By setting these fields, records appear to have been created at the time they were originally created on your old system.
Since these fields are intended to be Audit Fields, they can only be set on create (INSERT) and not on update. If the records already exist in Salesforce, they must be exported to a CSV file, deleted in Salesforce, and then imported with the updated information as new records.
Salesforce recommends enabling this feature only during data migration. In certain cases, such as routinely copying new data from an external system to Salesforce, this can be enabled permanently. This feature must be enabled by a System Administrator.

Important Considerations

  • Create Audit Fields is a generally available feature. A Salesforce Support video is available that demonstrates the feature. The video covers how to enable Create Audit Fields in Setup, how to set audit field values using the API during data migration, and how to perform a Data Loader import using the CreatedDate field.
  • This feature does not permit values to be updated, only inserted (this only works for INSERT, not UPSERT).
  • The LastModifiedDate and LastModifiedBy fields will not reflect the inserted value if a Task is associated with a Contact or Lead (WhoID) or other records such as Account, Opportunity, or Campaign (WhatID) during Task Insert.
  • Permission required to set audit fields: Modify All Data.
  • When Enhanced Email is enabled and EmailMessages are inserted, the associated Task records auto-created will not use the CreatedDate of the EmailMessage — they will have a CreatedDate of the date of insertion.
Resolution

The Create Audit Fields feature enables administrators and developers to set system-level audit fields via the API during data insertion. These fields can only be set on INSERT — not on UPDATE or UPSERT. The permission Modify All Data is required.

Fields Enabled by Create Audit Fields

The following fields are granted additional access through this feature:

  • CreatedByID
  • CreatedDate
  • LastModifiedByID
  • LastModifiedDate

Additional Lead Object Fields Available on Insert

The following conversion-related Lead object fields can also be set on INSERT:

  • IsConverted
  • ConvertedDate
  • ConvertedAccountId
  • ConvertedContactId
  • ConvertedOpportunityId

Supported Salesforce Objects

Create Audit Fields can be used on the following objects: Account, CampaignMember, CareService, Case, CaseComment, CodeSet, Contact, ContentNote, ContentVersion, Contracts, EmailMessage, FeedComment, FeedItem, FinancialGoal, FinancialPlan, HealthCondition, Idea, IdeaComment, Lead, Opportunity, Quote, Vote, Work Order, Task, Event, Attachment, and all custom objects.


Note: Set Audit Fields are also supported for Health Cloud and Financial Cloud Managed Package Objects, including Health Cloud objects such as CodeSet, HealthCondition, and CareService, and Financial Cloud objects such as FinancialPlan and FinancialGoal.

Knowledge Article Number

000386065

 
Loading
Salesforce Help | Article