Connector Configuration

Configuration

This guide presents the connector configuration for the generic HTTPS destination type.
UI label API field name Type Required Notification source type overrides Allowed values Default value Description
URL url Url true true N/A N/A The endpoint to which the request is sent. Test notifications are sent here using POST.
Additional body fields additionalBodyFields JSONObject true true N/A {} Custom static fields included in the JSON body of the request and used to provide additional data. Use standard JSON format (e.g., {"api_key":"aq7..."}). Overrides any top-level field with the same name already present in the request.
Headers additionalHeaders KeyValuePairs true true N/A {} Represents a JSON object where each key maps to a string value. Defines headers included in each request. Can be used to provide authentication data. Overrides the request header if one already exists.
Dynamic URL dynamicURL Url false true N/A N/A URL includes dynamic values. Supports templating to personalize webhook endpoints per alert. Overrides the defined URL.
Dynamic body fields dynamicBodyFields JSONObject false true N/A {} Add fields to the JSON body using dynamic content from the alert payload. This overrides the static body fields.
Dynamic headers dynamicHeaders KeyValuePairs false true N/A {} Insert dynamic values in HTTP headers based on alert content. Useful for passing runtime data such as tokens or custom identifiers.

Templating for dynamic routing

The dynamic fields support dynamic templating, enabling data-driven routing by inserting variables into the notification configuration.

Here are some customization examples:

Dynamic URL

{% if alert.status == 'Triggered' %} https://api.opsgenie.com/v2/alerts
{% else %}https://api.opsgenie.com/v2/alerts/{{alert.groupingKey}}/close?identifierType=alias
{% endif%}

Dynamic body fields

{% if alert.highestPriority == 'P1' %}
  {% set routing_key = "<critical_routing_key>"%}
{% elif alert.highestPriority == 'P2' %}
  {% set routing_key = "<error_routing_key>"%}
{% endif %}
{
  "routing_key": "{{routing_key | default(value = "<default_routing_key>")}}"
}

Dynamic headers

"Service-Name" : "{{alert.groups['service_name'] | default(value = "N/A")}}"

Introduction

Next Message Configuration

UI label	API field name	Type	Required	Notification source type overrides	Allowed values	Default value	Description
URL	`url`	`Url`	true	true	N/A	N/A	The endpoint to which the request is sent. Test notifications are sent here using POST.
Additional body fields	`additionalBodyFields`	`JSONObject`	true	true	N/A	`{}`	Custom static fields included in the JSON body of the request and used to provide additional data. Use standard JSON format (e.g., `{"api_key":"aq7..."}`). Overrides any top-level field with the same name already present in the request.
Headers	`additionalHeaders`	`KeyValuePairs`	true	true	N/A	`{}`	Represents a JSON object where each key maps to a string value. Defines headers included in each request. Can be used to provide authentication data. Overrides the request header if one already exists.
Dynamic URL	`dynamicURL`	`Url`	false	true	N/A	N/A	URL includes dynamic values. Supports templating to personalize webhook endpoints per alert. Overrides the defined URL.
Dynamic body fields	`dynamicBodyFields`	`JSONObject`	false	true	N/A	`{}`	Add fields to the JSON body using dynamic content from the alert payload. This overrides the static body fields.
Dynamic headers	`dynamicHeaders`	`KeyValuePairs`	false	true	N/A	`{}`	Insert dynamic values in HTTP headers based on alert content. Useful for passing runtime data such as tokens or custom identifiers.