Manage webhook variables

Variables inject dynamic or reusable values into webhook payloads, headers, and URL parameters. Custom variables store account-specific values you define. Built-in variables are provided automatically and carry Alert Rule event data from the alert that triggered the webhook.

Before you begin

• Administrator role in Company Settings

Add a custom variable

1. Open Company Settings from the Kontakt.io Launchpad.
2. In the navigation menu, select Webhooks.
3. Select the Variables tab.
4. Select Add Variable.
5. Enter a Name — names cannot start with an underscore or contain spaces.
6. Select a variable type:
   • Plain — the value is visible in the configuration.
   • Secret — the value is masked after saving. Use for API keys and tokens.
7. Enter a Value.
8. Enter a Description.
9. Select Save.

The variable is available in webhook payloads, headers, and URL parameters.

Edit a custom variable

1. In the Variables tab, locate the variable.
2. Select Edit.
3. Update the value or description.
4. Select Save.

Delete a custom variable

1. In the Variables tab, locate the variable.
2. Select Delete.
3. Review the list of webhooks that use this variable — deleting it will break those webhooks until the reference is removed or replaced.
4. Confirm deletion.

Built-in variables

Built-in variables carry data from the Alert Rule event that triggered the webhook, including the alert name, rule name, urgency level, triggering condition, and the entity involved. Available built-in variables depend on which Kio Apps are selected on the webhook. They cannot be edited or deleted and appear under the Built-in group when editing a webhook payload.