Skip to main content

Outbound integrations

Outbound integrations enable you to send data or notifications to tools such as Datadog, Slack, and PagerDuty.

Moogsoft Cloud includes generic outbound webhooks that you can use to send data to other tools as appropriate.

Note

Two different outbound webhooks are available: the alert webhook and the incident webhook. The incident webhook is used with the Send to Endpoint action in an incident workflow. It is recommended for most uses cases, unless you are sending alerts to external systems. For scenarios where you need to send alerts, use the alert webhook instead.

For more information, see Outbound incident webhooks.

See also Outbound Integrations API.

Webhook information

Webhooks are designed to be flexible and generic enough to support any external tool that can ingest JSON objects over HTTP or HTTPS.

Webhooks require the following types of information. Note that requirements vary depending on the type of webhook.

  • Type — Create an alert webhook to send alerts, or an incident webhook to send incidents.

  • Triggers — The conditions which cause the webhook to send data. This may be a filter to limit the data sent to the external system, or a configurable trigger.

  • URL — The external endpoint where you want to send your alerts or incidents.

  • Authorization — The authorization data required by the external endpoint.

  • Headers — You need to send data in JSON format, so specify Content-type = application/json.

  • Body — A JSON object with the alert or incident data you want to send.

    The Body field supports "smart type-ahead" functionality:

    1. Make sure there is a space before the cursor.

    2. Press the dollar sign ($) to open a pop-up menu.

    3. Select the alert or incident field you want to include in the payload.

      For alert webhooks, you can also enter ${alert_url} or ${incident_url} to include a URL in the payload. These URLs open the alert or incident directly in the Moogsoft UI.

      Incident webhooks use ${outbound.<integration_name>.external_name} to perform this function.

In this section: