List triggered notifications by webhook

curl --request POST \
  --url https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "start_date": "2026-10-13T00:00:00Z",
  "end_date": "2026-10-14T00:00:00Z",
  "filters": {
    "notification_types": [
      "invoice.finalized"
    ]
  },
  "limit": 25
}
'

import requests

url = "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications"

payload = {
    "start_date": "2026-10-13T00:00:00Z",
    "end_date": "2026-10-14T00:00:00Z",
    "filters": { "notification_types": ["invoice.finalized"] },
    "limit": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    start_date: '2026-10-13T00:00:00Z',
    end_date: '2026-10-14T00:00:00Z',
    filters: {notification_types: ['invoice.finalized']},
    limit: 25
  })
};

fetch('https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'start_date' => '2026-10-13T00:00:00Z',
    'end_date' => '2026-10-14T00:00:00Z',
    'filters' => [
        'notification_types' => [
                'invoice.finalized'
        ]
    ],
    'limit' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications"

	payload := strings.NewReader("{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "4f98dc25-6be7-4b0c-b25b-946c19511c5d",
      "webhook_id": "eb3a41d4-ca42-4cc1-b184-d208ab56ed65",
      "customer_id": "2055b7c2-e677-4446-81c7-e17136765f2c",
      "notification_id": null,
      "notification_type": "invoice.finalized",
      "first_attempted_at": "2026-10-13T23:59:00Z",
      "last_attempted_at": "2026-10-14T00:04:00Z",
      "last_response_status_code": 200,
      "num_attempts": 2
    }
  ],
  "next_page": null
}

{
  "message": "Limit must be between 1 and 100."
}

{
  "message": "Resource not found"
}

Webhooks

List triggered notifications by webhook

Retrieve all triggered notifications with delivery attempts to a webhook destination, with flexible filtering options to monitor, audit, and debug notification history. Results are ordered by the time of the first delivery attempt and limited to the most recent 30 days.

Use this endpoint to:

Identify whether notifications were triggered and delivered to webhook destinations when expected to debug issues
Understand and audit the timeline of triggered notifications
Monitor webhook destination health

Key response fields:

Array of triggered notifications containing:

ID of the specific triggered notification
Webhook destination ID
Customer ID
Notification configuration ID and type
first_attempted_at: Timestamp of the first delivery attempt to the webhook destination
last_attempted_at: Timestamp of the latest delivery attempt
Latest response status code
Number of total delivery attempts to the webhook destination

Usage guidelines:

Use filters to narrow down results and reduce pagination
Use the notification_ids filter to investigate triggered notifications for a specific notification configuration. Pass the configuration’s ID (e.g., 8deed800-1b7a-495d-a207-6c52bac54dc9), available as notification_id in delivery responses.
Filter for system notifications using notification type rather than notification ID
Use the Get Triggered Notification and Delivery Attempts endpoint to understand the total retry attempts for a specific triggered notification

POST

webhooks

{webhook_id}

triggered_notifications

List triggered notifications by webhook

curl --request POST \
  --url https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "start_date": "2026-10-13T00:00:00Z",
  "end_date": "2026-10-14T00:00:00Z",
  "filters": {
    "notification_types": [
      "invoice.finalized"
    ]
  },
  "limit": 25
}
'

import requests

url = "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications"

payload = {
    "start_date": "2026-10-13T00:00:00Z",
    "end_date": "2026-10-14T00:00:00Z",
    "filters": { "notification_types": ["invoice.finalized"] },
    "limit": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    start_date: '2026-10-13T00:00:00Z',
    end_date: '2026-10-14T00:00:00Z',
    filters: {notification_types: ['invoice.finalized']},
    limit: 25
  })
};

fetch('https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'start_date' => '2026-10-13T00:00:00Z',
    'end_date' => '2026-10-14T00:00:00Z',
    'filters' => [
        'notification_types' => [
                'invoice.finalized'
        ]
    ],
    'limit' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications"

	payload := strings.NewReader("{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.metronome.com/v1/webhooks/{webhook_id}/triggered_notifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"start_date\": \"2026-10-13T00:00:00Z\",\n  \"end_date\": \"2026-10-14T00:00:00Z\",\n  \"filters\": {\n    \"notification_types\": [\n      \"invoice.finalized\"\n    ]\n  },\n  \"limit\": 25\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "4f98dc25-6be7-4b0c-b25b-946c19511c5d",
      "webhook_id": "eb3a41d4-ca42-4cc1-b184-d208ab56ed65",
      "customer_id": "2055b7c2-e677-4446-81c7-e17136765f2c",
      "notification_id": null,
      "notification_type": "invoice.finalized",
      "first_attempted_at": "2026-10-13T23:59:00Z",
      "last_attempted_at": "2026-10-14T00:04:00Z",
      "last_response_status_code": 200,
      "num_attempts": 2
    }
  ],
  "next_page": null
}

{
  "message": "Limit must be between 1 and 100."
}

{
  "message": "Resource not found"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

webhook_id

string<uuid>

required

ID of the webhook destination. Only notifications from the same Metronome environment as your API token are returned.

Body

application/json

start_date

string<date-time>

required

Earliest first attempt to include (inclusive), as an ISO 8601 timestamp. Include a timezone to avoid ambiguity during filtering, e.g. 2026-10-13T00:00:00Z. Must be within the last 30 days and before end_date.

end_date

string<date-time>

Upper bound on first attempt time (exclusive), as an ISO 8601 timestamp. Include a timezone to avoid ambiguity during filtering. Defaults to the current time. Must be after start_date and no more than 30 days later. Set explicitly and keep fixed when paginating.

filters

object

Values within a filter are matched with OR; different filters are combined with AND. Omit a filter to include all values. Passing an empty array returns no results.

Show child attributes

limit

number

default:25

Maximum number of notifications per page. Defaults to 25; must be an integer from 1 to 100.

Required range: 1 <= x <= 100Must be a multiple of 1

next_page

string

Pagination cursor from the previous response. Omit for the first page. Pass unchanged in the request body with the same webhook_id, date range, and filters.

Response

Success

data

object[]

required

Matching triggered notifications, ordered by first_attempted_at descending. Empty when no triggered notifications match.

Show child attributes

next_page

string | null

Cursor for the next page of results. Null when there are no more results.

GET STARTED

ESSENTIALS

ENDPOINTS

List triggered notifications by webhook

Use this endpoint to:

Key response fields:

Usage guidelines:

Authorizations

Path Parameters

Body

Response