Creating and Managing Destinations

In the Integrations section of the Console, you can create Destinations for your integrations to link to:

  • Currently, only webhooks can be designated as the endpoint for an integration:

    • If you've defined a Notification Rule based on a system event, you can link this to a webhook integration Destination as the endpoint for the Notification. See Utilizing Events and Notifications for more details.

  • You can specify the type of authentication you want an integration to use when connecting to the Destination:

    • Currently, only the M3TER_SIGNED_REQUEST credentials format can be used as the authentication method used for connecting to a Destination.

    • If credentials are not required, then dummy values can be used.

When you have created a Destination, you can link an integration or Notification to it and complete your setup.

Creating Destinations

To create a Destination:

1. Select Integrations>Destinations. The Destinations page opens and list any existing Destinations.

2. Select Create destination. The Create page opens.

3. Enter a Name and Code:

  • Note that when you enter a name and click in the Code field, a default code is entered based on the name you've entered, which you can then edit as required.

4. Enter a URL for the webhook Destination.

5. Enter a Description for the Destination.

6. In the Credentials panel, select the Credential Type you want to use for authentication with the Destination:

  • Note that only the M3TER_SIGNED_REQUEST authentication method is currently available.

7. Enter the API key and API secret you want use for the M3TER_SIGNED_REQUEST authentication when connecting to the Destination.

8. Select Create Destination. You are returned to the Destinations page where the new Destination is listed:

  • The Destination is now available for linking your integrations or Notifications to it.

Managing Destinations

From the Destinations page, you can edit, view details, or delete a Destination.

To manage Destinations:

1. Select Integration>Destinations. The Destinations page opens and lists any existing Destinations.

2. If you want to edit a Destination select Edit:

3. On the Edit page, make your changes and select Update.

4. If you want to view the details of a Destination, select its NAME hotlink. The details page opens showing a Destination Details panel:

In this example, Notification Destination 1 details are shown. Note that you can Copy directly to your Clipboard certain key attributes:

  • URL

  • Destination id

  • API key

5. If you want to delete a Destination, select Delete:

A confirmation dialog appears. Select Yes to confirm the delete action.

Warning! If you try to delete a Destination to which you've linked an integration or Notification, then you won't be able to and an error message will show.

Next: Reviewing and Resolving Integration Events