> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create alert channel

> Creates a new alert channel

Requires `alert_channels:read_write` permission.

<ParamField body="name" type="string" required>
  Channel name (1–255 characters)
</ParamField>

<ParamField body="type" type="string" required>
  `slack`, `discord`, `email`, `webhook`, `pagerduty`, `teams`, `grafana_irm`, `ilert`, `incident_io`, `mattermost`, `pushover`, `ntfy`, `telegram`, or `sms`
</ParamField>

<ParamField body="config" type="object" required>
  Type-specific configuration. See [Alert channels](/alert-channels) for fields per type.
</ParamField>

<ParamField body="enabled" type="boolean" default={true}>
  Whether the channel is active
</ParamField>

<ParamField body="default_for_new_monitors" type="boolean" default={true}>
  Automatically link to newly created monitors
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Engineering Slack",
      "type": "slack",
      "enabled": true,
      "default_for_new_monitors": true,
      "broken_at": null,
      "broken_reason": null,
      "inserted_at": "2025-03-01T12:00:00Z",
      "updated_at": "2025-03-01T12:00:00Z"
    }
  }
  ```
</ResponseExample>