List all notifiers
Lists all notifiers in the organization, sorted by name. Labels are resolved unless exclude=labels.
Parameters
| Property | Type | Location | Description |
|---|---|---|---|
exclude | string | query | Exclude resolved label objects from each notifier response. The labelIds and labelNames fields are still returned. |
label | string[] | query | Filter by label names in your organization. Repeat the parameter for multiple names, for example ?label=prod&label=team-a. Names match case-insensitively after whitespace normalization; duplicates count once. Commas are part of a name, not separators. Reading resources never creates missing labels. |
label | string | query | How to combine label names: any (the default) requires at least one requested label on a resource; all requires every requested label on that same resource. For example, ?label=prod&label=team-a matches either label, while ?label=prod&label=team-a&labelMatch=all requires both. Unknown names have no matches with any and make all return no resources. Without label parameters, labelMatch has no effect. |
Request
Try itRun this request against your Axiom organization
Credentials stay in this browser tab and are only sent to Axiom when you run the request.
Response
200Notifiers in the organization.400Bad Request| Property | Type | Description |
|---|---|---|
created | string | Timestamp when the notifier was created |
created | string | Email or ID of the user who created the notifier |
created | boolean | true when the MCP server created this notifier |
disabled | boolean | Whether repeated delivery failures disabled the notifier. False when a user snoozed it with disabledUntil. Ignored on requests |
disabled | string | ISO timestamp until which the notifier is disabled (null if enabled) |
last | string | The delivery error that disabled the notifier. Empty for email notifiers and when disabled is false. Ignored on requests |
name | stringRequired | Human-readable name for the notifier |
properties | objectRequired | Configuration options for different notification channels. Only one channel should be configured per notifier. |
amp | object | Amp Orb webhook. The receiving plugin must accept {"text": "<monitor summary>"}. |
webhook | stringRequired | Secret HTTPS URL from the Amp plugin createWebhook registration. Returned encrypted on reads; submit it unchanged to retain it on updates. |
chatgpt | object | Published ChatGPT Workspace Agent API channel. Axiom sends {"input": "<monitor summary>"}. |
token | stringRequired | ChatGPT access token with the Workspace Agents scope |
trigger | stringRequired | API channel trigger ID beginning with agtch_ |
claude | object | Claude Code routine. Axiom sends a fixed text body when the monitor fires. |
routine | stringRequired | Routine ID from a Claude Code API trigger |
token | stringRequired | Bearer token for the routine |
cursor | object | Cursor automation webhook. Axiom sends a fixed context body when the monitor fires. |
token | stringRequired | Bearer token for the automation webhook |
webhook | stringRequired | Automation webhook URL from a Cursor automation |
custom | object | Configuration for custom webhook notifications with flexible headers and body template. Supports variable substitution in the body template using {{.Variable}} syntax. |
body | stringRequired | Template for the webhook body, supports variable substitution |
headers | object | HTTP headers to include in the request |
secret | object | Sensitive HTTP headers (tokens, keys) that should be masked in logs |
url | stringRequired | Custom webhook endpoint URL |
discord | object | Configuration for Discord notifications using bot token |
discord | string | Discord channel ID to send notifications |
discord | string | Discord bot token for authentication |
message | object | Go templates that replace the title and body of the notifier's default message. An empty field keeps the default. Variables include {{.Title}}, {{.Body}}, {{.Name}}, {{.Action}}, {{.Value}}, {{.Threshold}}, {{.Labels}}, {{.Groups}} and {{.MatchedEvent}}. If a template fails when a notification is sent, the default message is sent and the delivery records the error. |
body | string | Template for the message body |
title | string | Template for the message title |
discord | object | Configuration for Discord notifications using webhooks |
discord | string | Discord webhook URL |
message | object | Go templates that replace the title and body of the notifier's default message. An empty field keeps the default. Variables include {{.Title}}, {{.Body}}, {{.Name}}, {{.Action}}, {{.Value}}, {{.Threshold}}, {{.Labels}}, {{.Groups}} and {{.MatchedEvent}}. If a template fails when a notification is sent, the default message is sent and the delivery records the error. |
body | string | Template for the message body |
title | string | Template for the message title |
email | object | Configuration for email notifications |
emails | string[] | List of email addresses to receive notifications |
message | object | Go templates that replace the title and body of the notifier's default message. An empty field keeps the default. Variables include {{.Title}}, {{.Body}}, {{.Name}}, {{.Action}}, {{.Value}}, {{.Threshold}}, {{.Labels}}, {{.Groups}} and {{.MatchedEvent}}. If a template fails when a notification is sent, the default message is sent and the delivery records the error. |
body | string | Template for the message body |
title | string | Template for the message title |
jira | object | Configuration for Jira Service Management Ops alerts using an API integration |
api | stringRequired | API key of the Jira Service Management API integration |
microsoft | object | Configuration for Microsoft Teams notifications |
message | object | Go templates that replace the title and body of the notifier's default message. An empty field keeps the default. Variables include {{.Title}}, {{.Body}}, {{.Name}}, {{.Action}}, {{.Value}}, {{.Threshold}}, {{.Labels}}, {{.Groups}} and {{.MatchedEvent}}. If a template fails when a notification is sent, the default message is sent and the delivery records the error. |
body | string | Template for the message body |
title | string | Template for the message title |
microsoft | string | Microsoft Teams webhook URL |
opsgenie | object | Configuration for OpsGenie integration |
api | string | OpsGenie API key for authentication |
is | boolean | Whether to use EU region endpoints |
pagerduty | object | Configuration for PagerDuty integration |
routing | string | PagerDuty integration key for routing alerts |
token | string | PagerDuty API token for additional functionality |
slack | object | Configuration for Slack notifications using incoming webhooks |
message | object | Go templates that replace the title and body of the notifier's default message. An empty field keeps the default. Variables include {{.Title}}, {{.Body}}, {{.Name}}, {{.Action}}, {{.Value}}, {{.Threshold}}, {{.Labels}}, {{.Groups}} and {{.MatchedEvent}}. If a template fails when a notification is sent, the default message is sent and the delivery records the error. |
body | string | Template for the message body |
title | string | Template for the message title |
slack | string | Slack incoming webhook URL |
webhook | object | Configuration for simple webhook notifications |
url | string | Webhook endpoint URL |
updated | string | Timestamp when the notifier was last updated |
id | string | Unique identifier for the notifier |
label | string[]Required | IDs of labels assigned to this notifier. |
label | string[]Required | Names of assigned labels, including with exclude=labels; [] when unassigned. |
labels | object[] | Resolved labels assigned to this notifier. |
color | objectRequired | |
name | stringRequired | |
type | stringRequired | |
description | string | |
id | stringRequired | |
name | stringRequired |