> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseract.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication & Credentials

> Store website credentials and authorize Workflow Built Bots to use them.

Credential Center stores supported website login information for Workflow Built Bots. It can reduce repeated manual login steps when a workflow accesses an authorized page.

> **Note:** Credential Center is currently available for Workflow Built Bots only. Credential hosting for Agent Built Bots is coming soon.

Credentials are encrypted and are not exposed to the platform, third parties, or language models without your authorization.

## Add a Credential

1. Open `Credential Center`.
2. Select `Add`.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-center-add.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=eca100222f57a39a392ae7c9e17f820f" alt="Open Credential Center and select Add" width="1895" height="623" data-path="images/credential-center-add.png" />

3. Enter a clear **Credentials Name**, such as `Google Account` or `Instagram Account`.
4. Under **Identifier(s)**, enter the same login fields used by the target website. For example, use `Email`, `Username`, `Account`, or `Tenant ID` as the key and enter the corresponding value.
5. Select `Add Another Identifier` when the website requires more than one identifier.
6. Enter the password.
7. Add an **Authenticator App Key** when the website uses supported TOTP-based 2FA. You can enter the secret key or use the QR Code option available in the form.
8. Describe where the credential should be used in **Usage Rule**, such as `Use for all Google logins`.
9. Select `Confirm`.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/add-credential-form.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=eeefbe2e281c6e753e414dfd066b1e36" alt="Complete the Add Credential form" width="937" height="845" data-path="images/add-credential-form.png" />

### Login with Two Fields

When the website asks for one account identifier and one password, add one Identifier and the Password. For example, an Instagram login can use the phone number, username, or email as the Identifier.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-two-login-fields.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=76bbf577175a1681263d787038e34344" alt="Map a two-field login to one Identifier and Password" width="884" height="542" data-path="images/credential-two-login-fields.png" />

### Login with Three Fields

When the website asks for two account identifiers and one password, select `Add Another Identifier` and map both fields. For example, an AWS IAM login can use `Account ID`, `IAM username`, and `Password`.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-three-login-fields.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=341301c5c7b4097daf50efab6025346e" alt="Map a three-field login to two Identifiers and Password" width="1085" height="645" data-path="images/credential-three-login-fields.png" />

## Authorize a Workflow Built Bot

A saved credential is not automatically available to every Workflow Built Bot. Authorize only the workflows that need it.

### From Credential Center

1. Open `Credential Center` and locate the credential.
2. Select the authorization icon in the credential's **Actions** column.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-workflow-authorization-entry.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=280a9702dce72d976fac61545e45fa37" alt="Open the workflow authorization settings for a credential" width="1863" height="428" data-path="images/credential-workflow-authorization-entry.png" />

3. Under **Authorized Workflows**, select `Specific`.
4. Open `Not Authorized` and select the Workflow Built Bot that may use the credential.
5. Authorize the workflow and confirm the change.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-authorize-workflow.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=c2b356463ce17bf089f63814236b3a6f" alt="Select and authorize a Workflow Built Bot" width="1866" height="494" data-path="images/credential-authorize-workflow.png" />

### From the Start Node

1. Open the Workflow Built Bot and select `Workflow`.
2. Open the `Start` node.
3. Enable `Use Stored Credentials`.
4. Select `Settings` and choose an authorized credential.

<img src="https://mintcdn.com/browseract/NsOCzqG0hq750owC/images/start-node-stored-credentials.png?fit=max&auto=format&n=NsOCzqG0hq750owC&q=85&s=f84b3da300c274e26f868790a83c0d7e" alt="Enable Use Stored Credentials in the Start node" width="770" height="723" data-path="images/start-node-stored-credentials.png" />

## Choose an Auto-Login Option

Configure Website Auto-Login in the `Start` node.

<img src="https://mintcdn.com/browseract/NsOCzqG0hq750owC/images/start-node-auto-login-options.png?fit=max&auto=format&n=NsOCzqG0hq750owC&q=85&s=1e39c0717bb74f2c7d9ba50894bf25d9" alt="Choose a Website Auto-Login option in the Start node" width="812" height="621" data-path="images/start-node-auto-login-options.png" />

### Prompt for Credentials on Each Run

Use this option when the workflow needs different login information for each run. The user enters the required credential values when starting the task.

### Use Stored Credentials

Use this option for repeated or unattended runs. The workflow uses an authorized credential from Credential Center without asking the user to enter it again.

## Supported 2FA

Authenticator-app 2FA using a TOTP secret key or QR code is optional and can be added when the target website supports this setup.

Email and SMS verification should not be treated as supported stored-credential methods unless they are shown as available in the current product.

## Manage Credentials

### Edit a Credential

Select the edit icon in the credential's **Actions** column. Update the credential name, account information, password, Authenticator App Key, or Usage Rule, and then select `Confirm`.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/edit-credential.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=2f195c199943e6541ac7fdf12e0b5a1e" alt="Edit an existing credential" width="1280" height="598" data-path="images/edit-credential.png" />

If a website password changes, update the saved credential before the next run.

### Revoke Workflow Authorization

1. Open the credential's authorization settings.
2. Under **Authorized Workflows**, select `Specific`.
3. Open the `Authorized` tab.
4. Select the revoke icon for the Workflow Built Bot.
5. Confirm the change.

<img src="https://mintcdn.com/browseract/NsOCzqG0hq750owC/images/revoke-workflow-credential-authorization.png?fit=max&auto=format&n=NsOCzqG0hq750owC&q=85&s=82767b413549b78357ccf5c4ff6a3f7c" alt="Revoke a Workflow Built Bot's credential authorization" width="1875" height="540" data-path="images/revoke-workflow-credential-authorization.png" />

Revoking authorization may cause a Workflow Built Bot that depends on the credential to fail.

### View Usage Records

Select the usage-record icon in the credential's **Actions** column to review the available credential usage information.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/credential-usage-records.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=30837d2520b2be19f89743c7fbcf1e85" alt="Open credential usage records" width="1280" height="340" data-path="images/credential-usage-records.png" />

### Delete a Credential

Select the delete icon in the credential's **Actions** column when the credential is no longer needed.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/delete-credential.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=b21bb83b3f938aff9a43cf4fef945594" alt="Delete a credential from Credential Center" width="1326" height="256" data-path="images/delete-credential.png" />

Deleting a credential disables its use in authorized workflows. Check workflow dependencies before deleting it.

## Troubleshoot Login Failures

Check the following:

* The username, email, or account identifier matches the target website.
* The password has not changed or expired.
* The account is not locked or suspended.
* The Authenticator App Key is current and entered correctly.
* The Workflow Built Bot is authorized to use the credential.
* `Use Stored Credentials` is enabled in the Start node when stored credentials are required.

When contacting support, include the Task ID and the login error shown by the run. Do not send passwords or 2FA secret keys.
