View Hook Secrets

The End of Life (EOL) date of Rules and Hooks will be November 18, 2026, and they are no longer available to new tenants created as of October 16, 2023. Existing tenants with active Hooks will retain Hooks product access through end of life.

We highly recommend that you use Actions to extend Auth0. With Actions, you have access to rich type information, inline documentation, and public npm packages, and can connect external integrations that enhance your overall extensibility experience. To learn more about what Actions offer, read Understand How Auth0 Actions Work.

To help with your migration, we offer guides that will help you migrate from Rules to Actions and migrate from Hooks to Actions. We also have a dedicated Move to Actions page that highlights feature comparisons, an Actions demo, and other resources to help you on your migration journey.

To read more about the Rules and Hooks deprecation, read our blog post: Preparing for Rules and Hooks End of Life.

Because we plan to remove Rules and Hooks functions in 2026, you should create new Rules or Hooks only in your Development environment and only to test migration to Actions.

To learn how to migrate your Rules to Actions, read Migrate from Rules to Actions. To learn how to migrate your Hooks to Actions, read Migrate from Hooks to Actions.

You can see configured Hook Secrets for a Hook using the Dashboard or retrieve a list of Hook Secrets using the Management API.

View Hook Secrets using the Dashboard

1. Go to Auth0 Dashboard > Auth Pipeline > Hooks and click the pencil icon next to the Hook for which you want to view Secrets.
2. In the Hook Editor, click the wrench icon, and click Secrets.

All configured secrets for the selected Hook are listed.

Get Hook Secrets using the Management API

Make a GET call to the Get Hook Secrets endpoint. Be sure to replace HOOK_ID and MGMT_API_ACCESS_TOKEN placeholder values with your Hook’s ID and the Management API Access Token, respectively.

cURL

curl --request GET \
  --url 'https://{yourDomain}/api/v2/hooks/HOOK_ID/secrets' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN'

Value	Description
HOOK_ID	ID of the Hook for which you want to retrieve secrets.
MGMT_API_ACCESS_TOKEN	Access Tokens for the Management API with the scope update:hooks. To learn more, read Management API Access Tokens.

Hook Secrets are write-only. When retrieving secrets configured for a specified Hook, values will contain the placeholder text: _VALUE_NOT_SHOWN.