> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.instabase.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.instabase.com/_mcp/server.

# Managing secrets

> Use secrets to securely store and reference sensitive information.

When writing [custom functions](/automate/custom-functions#using-keys-in-custom-functions) or [configuring webhooks](/automate/deployments#configuring-notifications), you might need to reference or pass sensitive information such as API keys, access tokens, or login credentials. Using secrets, organizations can centrally define and manage these sensitive values.

## Creating secrets

Organization admins can create and manage secrets.

1. In the header, click the initials icon and select **Settings**.

2. Click **Secrets**.

3. Click **Add secret**.

4. Configure the secret.

   * **Name** -- A name for the secret. Names can contain letters, numbers, underscores, or hyphens and can't be changed after saving.

     > **Note**
     >
     > This name is what members see when adding secret keys to their custom functions. Use a brief but descriptive name that helps members identify the secret and its intended usage.

   * **Value** -- The secret value itself. You can enter text up to 45,000 characters in length or upload a file, such as certificate files. After saving, the input is encrypted and can't be viewed again.

   * **Workspaces** -- Which workspaces the secret is available to. To make the secret available to only some workspaces, use the input field to select from a list of all shared workspaces.

     > **Note**
     >
     > **All workspaces** makes the secret available in both shared and personal workspaces.

   * **Description** -- Optional notes or details about the secret and its usage.

5. Click **Add secret**.

## Updating secrets

After creating a secret, you can update its value, workspace availability, and description. You can't view a secret's current value.

1. In the header, click the initials icon and select **Settings**.

2. Click **Secrets** to view the secrets list.

3. In the secret's row, click the edit icon![Pencil icon.](/_fern-img/b4ea19b15837e4b064b8244bc307d55b8513ecb0b9135f785e601917e4736f1b.webp).

4. Edit the secret's value or other settings, then click **Save**.

## Deleting secrets

Deleting a secret deletes its value, affecting any custom functions that reference the secret. For your convenience, when deleting a secret, the confirmation modal lists any deployments in which the secret is referenced.

1. In the header, click the initials icon and select **Settings**.

2. Click **Secrets** to view the secrets list.

3. In the secret's row, click the delete icon ![Icon of a trash can.](/_fern-img/fde5c4ebfaee103ef10fc55c5b5119885924befbf5e79ea1da8cbf46d20448a8.webp).

4. Click **Delete** to confirm.