Skip to main content

​
Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Postman connector page.

​
Send monitor results to StackOne

Add a Post monitoring results integration in Postman that sends each monitor run to the StackOne Native Webhook URL.

1

Retrieve StackOne Native Webhook URL

The Native Webhook URL is generated once an account has been linked.

  • Open the linked account in StackOne.
  • Copy the value from Native Webhook URL.
  • The URL contains a secret token that identifies the linked account, so store it securely and do not share it.
2

Open Custom Webhooks

Sign in to Postman and open the Custom Webhooks integration.

  • In the left sidebar, click Integrations.
  • Click the Custom Webhooks card.
  • Click the Connections tab.
Integrations page with the Integrations menu item and the Custom Webhooks card highlighted
3

Add a monitoring results integration

Start a new integration for monitor results.

  • Next to Post monitoring results, click Add integration.
Custom Webhooks Connections tab with Post monitoring results and the Add integration button highlighted
4

Choose the monitor

Name the integration and pick the monitor whose runs should be sent.

  • Nickname: enter a name, for example StackOne Integration.
  • In Choose workspace, select the workspace that holds the monitor.
  • In Choose Monitor, select the monitor.
Add integration form with the Nickname, Choose workspace and Choose Monitor fields highlighted
5

Paste the URL and save

Point the integration at StackOne and choose when Postman sends results.

  • Paste the Native Webhook URL into Webhook URL.
  • Under Configure when monitor runs must be notified, select Notify for all completed monitor runs, or Notify for 3 failures and then first success to send only failure streaks and the recovery.
  • Click Add Integration.
  • Repeat these steps for each monitor that should send events.
Add integration form with the Webhook URL field, the notification options and the Add Integration button highlighted

​
Available webhook events

The following Postman event can be enabled. Only events selected in StackOne are delivered; Postman sends every notification for the monitor and StackOne ignores it when the event is not enabled.

1

Monitor events

Events related to Postman monitors.

  • Monitor Run Completed (monitor.run_completed) — Fired when a run of the selected monitor completes, as chosen under Configure when monitor runs must be notified.

​
Delivery format

Details of how Postman delivers events to StackOne.

1

One request per monitor run

Postman sends one JSON request for each notified monitor run, holding the monitor and collection names and IDs, the user who owns the monitor, and the run metrics. Requests are not signed; the token in the Native Webhook URL identifies the linked account.

​
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.