Secrets Management ๐Ÿ”’

Keep your sensitive information safe and accessible in your workflows without exposing credentials, API keys, or tokens.

Managing Secrets

You can create, view, and manage your secrets in the Graph Compose dashboard.

Using Secrets in Workflows

You can use secrets in your workflow nodes using the special $secret template syntax.

SYNTAX Secret Reference Pattern

Use this syntax to reference secrets in your workflow:

{{ $secret('secret_name') }}

Where secret_name is the name of your secret as it appears in the dashboard.

This $secret('secret_name') syntax can be used anywhere you need to insert sensitive data within your node definitions, such as in HTTP request headers, body content, or dynamic parts of url strings.

Example: HTTP Request with Secret

Here's how to use a secret in an HTTP request node:

{
  "url": "https://api.example.com/data",
  "method": "GET",
  "headers": {
    "Authorization": "Bearer {{ $secret('api_key') }}"
  }
}

When the workflow runs, {{ $secret('api_key') }} will be replaced with the actual value of the secret stored in your organization.

Troubleshooting

If your workflow fails with a secret resolution error, check:

  • โœ“ Secret exists in your organization
  • โœ“ Secret name spelling is correct
  • โœ“ Secret reference syntax is correct: {{ $secret('secret_name') }}
  • โœ“ You have necessary permissions to access the secret

Ready to make your workflows more secure? Head over to the Secrets Dashboard to get started! ๐Ÿš€