title: "Connectors" date: "2024-08-07" description: "This tutorial describes how to set up and manage connectors per connector type as part of Notification Center." search: exclude: true noindex: true
Connectors
Overview
At its basic level, Notification Center allows users to create outbound push notifications based on a set of definitions making up a connector configuration for connecting to a particular third-party destination or connector type (e.g., Slack, PagerDuty, or HTTPS URL).
Users can define multiple connectors (e.g., “slack-workspace-1”, slack-workspace-2”) per connector type.
A connector configuration, made up of individual field templates, is needed to connect to the relevant connector type. Templating the target configuration parameters allows the user to perform message routing to different destinations per connector type by parameterizing some part of the destination's input. The user creates these templates using separate focused template strings for a small set of carefully chosen fields unique to each connector type.
Getting started
To get started, navigate to Data Flow > Notification Center. Select a connector type as the basis for your notification.
Connector setup
- In the Connectors tab, click + Create new connector.
-
Define the custom or Slack connector configuration in the popup modal that appears.
-
Once complete, click Test connector. This will send a test notification to the Channel selected.
Connector configuration
Custom
Field | Description |
---|---|
Connector name | Select a name that will allow you to easily recognize the connector configuration. |
Description | [Optional] Provide a description for the connector. |
URL | Provide a URL where notifications should be sent. |
Method | Select between POST, GET, and PUT. |
Additional headers | Headers added will be included in each notification request. They can be used to provide authentication data. This overrides the request header if one already exists. |
Additional body fields | Included in the body of the request, these fields may be used to provide additional data for the request. This overrides any top-level field with the same name already present in the request. |
Slack
Field | Description |
---|---|
Connector name | Select a name that will allow you to easily recognize the connector configuration. |
Description | [Optional] Provide a description for the connector. |
Integration name | Select an integration from the dropdown menu. |
Channel | [Optional] Dynamic, templatable field that defines where a notification is sent within a Slack workspace |
Fallback channel | If the notification cannot be delivered to the original channel, this default channel will be used. |
Managing existing connectors
Navigate to Notification Center > Connector types > Connectors to manage your connectors. The Connectors tab consolidates all of your existing targets, including a description and date of last update.
Take any of the following actions:
- You may modify existing targets by clicking on the pen icon.
- Delete a target by clicking on the garbage icon.
- Click on the Test drop-down menu to send test a test notification.