Salesforce DX Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
How Salesforce Developer Experience (DX) Tooling Changes the Way You Work
Provide Developers Access to Salesforce DX Tools
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Supported Scratch Org Editions and Allocations
Build Your Own Scratch Org Definition File
Create a Scratch Org Based on an Org Shape
Create Scratch Orgs
Scratch Org Snapshots
Select the Salesforce Release for a Scratch Org
Deploy Source From Your Project to the Scratch Org
Retrieve Source from the Scratch Org to Your Project
Scratch Org Users
Manage Scratch Orgs from the Dev Hub Org
Scratch Org Error Codes
Sandboxes
Track Changes Between Your Project and Org
Work with Data
Development
Build and Release Your App
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Scratch Org Error Codes

If scratch org creation fails, the system generates an error code that can help you identify the cause. Some of these errors are generated by the SignupRequest API and apply to all org signups.

These error codes are specific to scratch org signups. Additional error codes for other org signup scenarios are included in the Object Reference for the Salesforce Platform: SignupRequest.

Note

Error Code Description
C-1007 Duplicate username.
C-1015 Error while establishing the new org’s My Domain (subdomain) settings. Contact Salesforce Support for assistance.
C-1016 Error while configuring the OAuth connected app for Proxy Signup. Verify that your connected app has a valid consumer key, callback URL, and unexpired certificate (if applicable).
C-1018 Invalid subdomain value provided during sign-up.
C-1019 Subdomain in use. Choose a new subdomain value.
C-1020 Template not found. Either the template doesn’t exist or it was deleted.
C-1033 Template is the wrong version.
C-1034 Can’t create the org. Contact Salesforce Customer Support for assistance.
C-9998 Not a valid scratch org. Contact Salesforce Customer Support for assistance.
C-9999 Generic fatal error. Contact Salesforce Customer Support for assistance.
S-1017 Namespace isn’t registered. To use a namespace with a scratch org, you must link the Developer Edition org where the namespace is registered to a Dev Hub org. See Salesforce Help: Link a Namespace to a Dev Hub Org.
S-2006 Invalid country.
SH-0001 Can't create scratch org from org shape. Contact the source org admin to add your Dev Hub org ID. From Setup, in the Quick Find box, enter Org Shape, and then select Org Shape.
SH-0002 Can't create scratch org. No org shape exists for the specified sourceOrg. Create an org shape and try again.
SH-0003 Can't create scratch org from the org shape because it was created on a previous Salesforce release version and is outdated. Recreate the org shape and try again.
SN-0001 The snapshot has expired. Create another snapshot, then try again.
SN-0002 The snapshot doesn’t belong to the specified Dev Hub org. Run the command with the appropriate --target-dev-hub.
SH-9999 Can’t validate org shape due to fatal error. Contact Salesforce Customer Support for assistance.
VR-0001 Can’t create the scratch org. Try again later.
VR-0002 Can’t create the scratch org. Check that the release value is valid. If no release value was specified, contact Salesforce Customer Support.
VR-0003 Can’t create the scratch org. Check that the release value is valid. If no release value was specified, contact Salesforce Customer Support.