RECENT UPDATES:
18-Nov-2026 | v7.13.1 | All new article

Change Log

  • 18-Nov-2026 | v7.13.1 | All new article

Contributors:

{
  "id": 2418,
  "name": "Adam Wilson",
  "url": "/adam-wilson"
}
Adam Wilson - Logo Pogo

Secrets Manager

Secrets Manager gives you a secure, central place to store API keys, tokens and other credentials for integrations like Slack, WhatsApp and Telegram.

You can find it under 'Settings' > 'Secrets Manager'. It works like a password manager for your site, storing any credentials you want to keep in one place rather than scattered across external notes or emails. Secrets Manager is available on all plans.

Secrets are organised into Groups, with each Group holding any number of name-value Fields. When you create a Group, you can choose a template type for Slack, WhatsApp or Telegram that pre-fills the fields those integrations typically need, or start from a blank Custom group.

Groups

Each Group is shown as its own panel, with its fields listed below the Group header. From the header you can reorder Groups using the drag handle (), collapse or expand the Group using the arrow icon (), add a new field with "+ Create Field", and open the Group options menu ().

Within each Group, fields are listed with the following columns:

Column
Description
Name

The name of the field. eg: "channel_id"

System Name

The unique identifier for the field, made up of the Group's system name followed by the field name. eg: "test.channel_id"

Click the copy icon () to copy the System Name to your clipboard.

Value

The stored secret. If the field is set to hide its value, only the last 4 characters are shown. eg: "••••••3455"

Click the copy icon () to copy the full value. See Permissions for who can reveal and copy hidden values.

Actions

Use the edit icon () to update the field, or the delete icon () to remove it.

Creating a Group

Click "+ CREATE GROUP" at the top right of the page to open the 'Create New Group' panel.

Field
Description
Group Name

Required. The display name for the Group. eg: "Slack Notifications"

Description

An optional description to help you and other admins identify what the Group is used for.

Type

Required. The template used to pre-fill the Group's fields. Available options are:

  • Slack
  • WhatsApp
  • Telegram
  • Custom

See Group Types below for the fields each type adds.

Below the Group settings, each field is shown in its own block with the following settings:

Field
Description
Name

Required. The name of the field. eg: "bot_token"

System Name

Generated from the Group and field names. Use the copy icon () to copy it.

Value

Required. The credential or secret to store, such as an API key, token or ID. Use the copy icon () to copy the value.

Hide value

When checked, the value is masked in the field list, showing only the last 4 characters. This is checked by default.

To remove a field from the Group before saving, click the delete icon () in that field's block. To add more fields, click "+ Add Custom Fields". When you're done, click "SAVE".

Group Types

Selecting a template type pre-fills the fields typically required for that integration, so you only need to enter the values. You can still remove any of these fields or add your own with "+ Add Custom Fields".

Type
Pre-filled Fields
Slack
  • bot_token
  • webhook_url
  • channel_id
WhatsApp
  • access_token
  • phone_number_id
  • business_account_id
  • webhook_verify_token
Telegram
  • bot_token
  • chat_id
  • webhook_secret
Custom

Starts with one empty field for you to name and fill in.

Editing and Deleting Groups

Click the options menu () in a Group's header and select "Edit Group" or "Delete Group".

Editing a Group lets you change its "Group Name" and "Description". The Group's type is set when the Group is created and is not shown when editing. Fields are managed individually from the Group's field list (see Fields below).

Fields

Adding a Field

To add a field to an existing Group, click "+ Create Field" in that Group's header to open the 'Create New Field' panel.

Field
Description
Name

Required. The name of the field. eg: "api_key"

System Name

Pre-filled with the Group's system name, followed by the field name as you type it. eg: "test.api_key"

Value

Required. The credential or secret to store.

Hide value

When checked, the value is masked in the field list, showing only the last 4 characters. This is checked by default.

Click "SAVE" to add the field to the Group.

Editing and Deleting Fields

In the Group's field list, click the edit icon () in the 'Actions' column to update a field, or the delete icon () to remove it.

When a credential is rotated or regenerated by the external service, update the value here so every admin is working from the current one.

Permissions

Access to Secrets Manager is controlled through its own set of permissions under 'Settings' > 'Admin User Roles':

Permission
Description
Can View

Allows the admin to open Secrets Manager and see Groups and fields. Hidden values remain masked.

Can Create

Allows the admin to create new Groups and fields.

Can Edit

Allows the admin to edit Groups and fields, and to reveal and copy the full value of hidden fields.

Can Delete

Allows the admin to delete Groups and fields.

Revealing or copying the full value of a hidden field requires the "Can Edit" permission. Admins with "Can View" only will see the masked value.

See Admin User Roles for details on configuring roles and permissions.