Skip to main content

Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.

Connector Profile

Matillion - OAuth 2.0 (Client Credentials)
2

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Matillion - OAuth 2.0 (Client Credentials)

Webhook setup

This connector uses Manual Webhooks. Matillion (Data Productivity Cloud / Maia) has no webhook management API, so the notification is configured once in the Matillion UI using the StackOne webhook URL and the payload template below. Notifications fire only for scheduled or API-driven pipeline runs — runs started manually from Designer never generate notifications.

1

Open Profile & Account

Log in to Matillion and click Profile & Account at the bottom of the left navigation bar.

Matillion home page with the Profile & Account button highlighted in the left navigation bar
2

Open Notifications

In the menu that opens, click Notifications under your user section.

Profile & Account menu open with the Notifications item highlighted
3

Add a notification

On the Notifications page, click Add notification.

Notifications page with the Add notification button highlighted
4

Select scope

Select the Project and Environment you want StackOne to receive events for. To cover several projects, repeat this guide once per project/environment pair.

Add notification form with the Project and Environment selects highlighted
5

Add completion alerts

Under Pipeline completion alerts, click Add.

Add buttons highlighted for the Pipeline completion alerts and Anomaly alerts sections
6

Choose triggers and Webhook delivery

In the alert card, select the run outcomes to deliver, then under How do you want to receive this notification? tick Webhook.

  • Select Success, Failure, Cancelled and Skipped to enable all completion events
  • Tick Webhook as the delivery method
Completion alert card with the Success, Failure, Cancelled and Skipped checkboxes ticked and the Webhook delivery option highlighted
7

Fill in the webhook fields

Three fields appear when Webhook is ticked.

  • Webhook URL — paste the StackOne webhook URL for this connected account
  • Webhook Name — any descriptive name, e.g. StackOne
  • Payload Template — paste the template from the next step exactly as given
Webhook URL, Webhook Name and Payload Template fields shown after ticking Webhook
8

Paste the completion payload template

StackOne relies on this exact template to route events — paste it into Payload Template without modification (the View available variables link shows the supported placeholders):

Payload Template filled with the StackOne completion template and the Add notification button highlighted
9

Save

Click Add notification. The new notification appears in the list with Webhook delivery.

Notifications list showing the saved StackOne webhook notification row
10

Optional — add anomaly alerts

To also receive duration-anomaly events, click Add under Anomaly alerts (or edit the saved notification), tick Enable anomaly alerts, choose Webhook, fill the same Webhook URL, and paste this anomaly template instead, then click Save:

Anomaly alerts card with the anomaly payload template filled and the Save button highlighted

Available webhook events

The following events are emitted by this connector once the notification is configured.

1

Pipeline run events

Events describing the outcome of scheduled or API-triggered pipeline runs.

  • Pipeline Run Succeeded (pipeline_run.succeeded) — Fired when a pipeline run completes with status SUCCESS
  • Pipeline Run Failed (pipeline_run.failed) — Fired when a pipeline run completes with status FAILED
  • Pipeline Run Cancelled (pipeline_run.cancelled) — Fired when a pipeline run is cancelled
  • Pipeline Run Skipped (pipeline_run.skipped) — Fired when a scheduled pipeline run is skipped
  • Pipeline Run Duration Anomaly (pipeline_run.anomaly) — Fired when a run’s duration deviates significantly from its historical baseline (requires anomaly alerts enabled and a historical baseline)

Delivery format

Matillion renders the payload template on each delivery, substituting the ${variable} placeholders (the full list is behind View available variables on each alert card). Payloads are not signed (no HMAC or signature header) — the static "source":"stackone" field and the unguessable webhook URL identify legitimate deliveries. One HTTP POST is sent per pipeline run outcome.

1

Template variables

Completion alerts support ${pipelineName}, ${status}, ${finishedAt}, ${pipelineExecutionId}, ${projectId} and ${accountId}. Anomaly alerts additionally support ${environmentDisplayName}, ${startedAt}, ${elapsedDurationSeconds}, ${expectedUpperBoundSeconds}, ${expectedLowerBoundSeconds} and ${triggerType}.

Available template variables dialog listing the completion alert variables

Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.