Salesforce Docs Portal

Update Named Credentials After a My Domain Change

To simplify the setup of authenticated callouts, you can use a named credential as the callout endpoint. When your My Domain login URL or site login URL changes, named credentials that use that URL stop working. Because DevOps Center uses named credentials, you can’t access DevOps Center environments when the org’s My Domain login URL changes. To reestablish the impacted authentication callouts, update the URL field for the affected named credentials.

Required Editions

Available in: both Salesforce Classic and Lightning Experience
Available in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions
User Permissions Needed
To view named credentials: View Setup and Configuration
To create, edit, or delete named credentials: Customize Applications
  1. From Setup, in the Quick Find box, enter Named Credentials in the Quick Find box, then select Named Credentials.
  2. To modify an existing named credential, click Edit.
    To find the affected named credentials, look for your old My Domain login URL or site login URL in the URL field.

    To locate the named credential records that DevOps Center uses to access your org, look for the environment’s DevOps Center record ID in the Label field. DevOps Center uses this pattern: environmentRecordID_projectName_environmentName_sequentialNumber.

  3. In the URL field, replace your old login URL with your new login URL.
    For example, if the named credential uses your My Domain login URL, replace https://oldMyDomainName.my.salesforce.com with https://newMyDomainName.my.salesforce.com.

    Or if the named credential uses your site URL, replace https://oldMyDomainName.my.site.com/hr/jobpostings with https://newMyDomainName.my.site.com/hr/jobpostings.

  4. Deselect Start Authentication Flow on Save and save your changes.
  5. Verify your changes.
    1. Trigger a callout that uses the updated named credential.
      For example, use aAnn external service that uses the named credential to access your org through Salesforce Connect. Or access DevOps Center and perform an operation against the environment that uses the named credential.
    2. When prompted, reauthenticate with your credentials for the affected org.
      If your authentication fails, double-check the URL and update the named credential record if needed.

The first time a user accesses functionality that uses the updated named credential, the user is prompted to reauthenticate. Include this detail in your communication plan for the My Domain change.

See Also