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.