Get the alert settings · Ownrecord docs

Returns how the organization's alerts are delivered in the mode of the request. Every alert is in the console inbox. Critical alerts are always emailed to the members whose role handles them (e.g. tax managers and owners for registration alerts) and posted to every Slack channel; email.high says whether high alerts are emailed too (immediate, the default, or off), and each Slack channel's minSeverity whether it gets high alerts. Info alerts stay in the inbox.

Slack channels show their name and a hint of the webhook URL; the URL itself is never shown again.

At a glance

REST: GET /api/v1/alert_settings
MCP tool: alert_settings_get
Operation ID: alert_settings.get
Scope: Organization
Permission: org:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the org:read scope
Since: M7

Request

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`object`	`"alert_settings"`
`livemode`	boolean
`email`	object
`email.high`	one of `immediate`, `off`
`slackChannels`	array of object
`slackChannels[].id`	`sec_…` ID
`slackChannels[].object`	`"slack_channel"`
`slackChannels[].name`	string
`slackChannels[].urlHint`	string
`slackChannels[].minSeverity`	one of `high`, `critical`
`slackChannels[].createdAt`	date-time
`slackChannels[].createdBy`	string
`slackChannels[].lastTest`	object or null
`updatedAt`	date-time or null
`version`	integer (at least 0)

Examples

High alerts emailed, one Slack channel

HTTP

GET /api/v1/alert_settings
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "alert_settings",
  "livemode": true,
  "email": {
    "high": "immediate"
  },
  "slackChannels": [
    {
      "id": "sec_01m4ttwd3veh9apbewxheq5xad",
      "object": "slack_channel",
      "name": "#tax-alerts",
      "urlHint": "hooks.slack.com …x7Qa",
      "minSeverity": "high",
      "createdAt": "2026-10-13T12:00:00.000Z",
      "createdBy": "usr_01m4ttwd3veh9apbewxheq5xh6",
      "lastTest": null
    }
  ],
  "updatedAt": "2026-10-13T12:00:00.000Z",
  "version": 2
}

Errors

Code	HTTP status	When	What to do
`permission_denied`	403	You can't read this organization's settings.	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

High alerts emailed, one Slack channel#

Errors#