# Refresh Named Credentials

To learn more about the Named credentials maintenance, see [Maintaining Named Credentials](/integrations/setting-up-limio-for-salesforce/detailed-salesforce-setup/named-credentials-package/named-credentials.md).<br>

* Who can refresh Named Credentials?\
  Any active Limio user (regardless of the Role).
* How often do you need to refresh your Limio Named Credentials?\
  The frequency of this process needs to be aligned with the Refresh token expiration term defined in your Amazon Cognito tenant in case your Authorization user changes.

## **How to refresh Limio credentials?**

### For new Named Credentials + External Credentials:

Available in LFS version 13.00 or later

1. Go to **Setup** → **Named Credentials**
2. Click on the **External Credentials** tab
3. Click **Limio**, scroll down to the **Principals** section, and click **Authorize** in the row actions.
4. You will be redirected to the new tab where prompted to enter your relevant **Limio org credentials**. Click Submit and go back to SF.
5. When the authentication is successful, retest your flows again.

| <p><strong>For legacy named credentials:</strong><br><br>Go to <strong>Setup</strong> → <strong>Named Credentials</strong><br><br>Find <strong>Limio</strong> and press Edit.<br><br><img src="/files/Do4TmyMzPXwvnANt3FbW" alt=""><br><br><strong>1.</strong> The following values should be populated:<br>- Name & Label: Limio<br>- URL: \<the URL to your Limio Subscription Commerce Platform> (e.g. <a href="https://mydomain.dev.limio.com/"><https://mydomain.dev.limio.com/></a> )<br><br>- Identity Type: Named Principal<br><br>- Authentication Protocol: OAuth 2.0<br><br>- Authentication Provider: i42\_Hub<br><br>- Scope: \<the link to your Limio Subscription Commerce Platform + /api> (e.g. <a href="https://mydomain.dev.limio.com/api)"><https://mydomain.dev.limio.com/api>)</a><br><br><strong>2</strong>. Make sure the checkbox <strong>“Start Authentication Flow on Save"</strong> is checked<br><br>As soon as you click <strong>Save</strong>, you will be <strong>redirected</strong> to the Limio auth page to submit your credentials.<br><br><strong>3</strong>. Enter your credentials from the relevant <strong>Limio environment:</strong><br><br>According to the example from step 1, you would enter your credentials for <https://mydomain.dev.limio.com>.<br><br>When the authentication is successful, the Authentication Status is Authenticated.<br><br><img src="/files/6rJ2ROC3uY02qcQ4AeGN" alt=""></p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## How to refresh Zuora credentials?

If you're using **Named Credentials with External Credentials** for Zuora authentication, follow these steps to update your credentials:

1. Go to **Setup** → **Named Credentials**
2. Click on the **External Credentials** tab
3. Locate the **Zuora** entry and click **Edit** from the row actions under the **Principals** section.
4. In the **Edit Principals** modal:
   * In the **Authentication Parameters** section, update or add the following:
     * `Name: Username` → `Value: your Zuora username`
     * `Name: Password` → `Value: your Zuora password`
5. Click **Save**.
6. Once saved, **retest your Limio for Salesforce flows** to confirm the credentials are working correctly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.limio.com/integrations/using-limio-for-salesforce/troubleshooting/refresh-credentials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
