When creating or editing a Private Integration in the Integrations Dashboard (Build > Integrations in the Agentic Hub), four tabs are shown: Details, Security Scheme, Integration Parameters, and Tool Parameters.
For a Public Integration, only three tabs are shown: Details, Integration Parameters and Tool Parameters.
The Integration Parameters tab defines general configuration and connection parameters that apply to the Integration as a whole. These values are shared by all Tools that belong to this Integration, unless a specific Tool overrides them in the Tool Parameters tab.
If no parameters have been added yet, the interface will display the message: No parameters configured yet.
To add a parameter, click on + Add new parameter. Then complete the following fields:
Internal name used to reference the parameter. This name should be descriptive and consistent, as it can be used by all Tools in the Integration.
Indicates the kind of parameter being defined:
-
Used for fixed configuration values such as connection settings, base URLs, timeouts, or other static values that apply across all Tools in the Integration.
-
(Less common in Integration Parameters) For dynamic values typically provided by the Agent or user context at runtime.
-
Allows automatic resolution of values from the runtime session (for example, project or user identifiers). When the key matches a known context variable, the Value field can be left empty.
To reference the OAuth token from the current session, set the Key to a descriptive name (for example, Authorization) and enter oauth_token in the Value field. This lets internal tools consume the token from the session context.
The oauth_token and api_token context variables are restricted to internal tools. If an external tool references either one, the action is aborted with an error indicating that the tool cannot receive that context variable.
Defines the current value assigned to the parameter in the Project. For Config parameters, this field is required. Values can be literal (e.g., a URL) or reference a Secret by name. For Context parameters, this field is optional and typically left blank.
Specifies the type of data expected for this parameter. Common options include:
- Boolean
- Decimal
- JSON
- Number
- String
Select this option if the parameter must be provided in order for the Integration to work correctly.
Select this option when the parameter value contains sensitive information that must be protected (e.g., credentials or tokens). When selected, the value is stored as a secret and handled securely.
To remove a parameter, click on the trash icon. Then confirm the action by clicking on the check icon that appears.