Create & Manage Secrets

Prev Next

Secrets are used to validate the calls that your API receives to ensure they are legitimate.

Create a Secret

  1. Sign in to your site

  2. Navigate to Developer Tools and select the Secrets menu Secrets option under the Developer Tools tab on the left-hand navigation menu.

  3. Click the plus sign button in the bottom right corner Create new secret button.

  4. Add the Label and SecretCreate fields.

    • Label: Give the secret a name so that you can select it when configuring secrets elsewhere in the platform.

    • Secret: For best practice, ensure your secrets are more than 8 characters and include lowercase, uppercase, numbers, and special characters.

      Note: You will not be able to view the secret after it has been created.

  5. Click SaveSave new secret.

  6. Now that the secret has been configured you can use it in 3 areas within the platform:

Edit a Secret

  1. Sign in to your site

  2. Navigate to Developer Tools and select the Secrets menu Secrets option under the Developer Tools tab on the left-hand navigation menu.

  3. If a secret is in use it will display a Forms tag and/or an Approval Webhook tag with a number highlighting how many forms or approval webhooks the secret is used in Forms tag.

  4. To edit the secret, click the pencil iconEdit button.

  5. Update the Label or the Secret ValueEdit label or secret.

  6. Click SaveSave secret button.

Delete a Secret

Note: You are unable to delete a secret that is currently in use so make sure to remove the secret from any forms or approval webhooks it is being used in first.

  1. Sign in to your site

  2. Navigate to Developer Tools and select the Secrets menu Secrets option under the Developer Tools tab on the left-hand navigation menu.

  3. Select the trashcan icon next to a secret Delete secret trashcan button.

  4. Select the Delete button on the pop-up that says Are you sure you want to delete this secret?Delete confirmation pop-up.