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.
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. |