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

# Create an Alert Channel

> Creates a single alert delivery channel for your workspace.



## OpenAPI

````yaml post /v1/risk/channels
openapi: 3.0.0
info:
  title: Range Risk API
  description: The Range Risk API for risk assessment of crypto addresses.
  version: 1.7.8
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - name: Risk
    description: Get risk information about a crypto address.
  - name: Risk v2
    description: >-
      Address risk assessment, workspace configuration, and signals catalogue
      (API v2).
  - name: Simulator
    description: Simulate a transaction on a network.
  - name: Alert Templates
    description: Browse alert rule templates available to the workspace.
  - name: Alert Rules
    description: Create and manage workspace alert rules.
  - name: Alert Events
    description: List and retrieve fired alert events.
  - name: Channels
    description: Configure alert delivery channels.
paths:
  /v1/risk/channels:
    post:
      tags:
        - Channels
      summary: Create a channel
      description: >-
        Creates a single channel for your workspace. Slack, Discord, and generic
        webhooks require params.webhook_url; PagerDuty requires
        params.routing_key; Email requires params.recipients (array of
        addresses); incident.io requires params.url; Telegram params are
        generated server-side.
      operationId: createChannel
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAlertChannelDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertChannelDto'
components:
  schemas:
    CreateAlertChannelDto:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 255
          description: Display name for the channel.
          example: My Slack Channel
        type:
          enum:
            - slack
            - telegram
            - discord
            - webhook
            - pagerduty
            - email
            - incidentio
          type: string
          description: Channel delivery type.
          example: slack
        params:
          type: object
          description: >-
            Type-specific parameters. Slack, Discord, and generic webhooks
            require webhook_url. PagerDuty requires routing_key. Email requires
            recipients (array of addresses). incident.io requires url and token.
            Telegram is generated server-side.
          additionalProperties: true
          example:
            webhook_url: https://hooks.slack.com/services/T00/B00/xxxx
      required:
        - name
        - type
    AlertChannelDto:
      type: object
      properties:
        id:
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        workspace_id:
          type: string
          example: workspace-123
        name:
          type: string
          example: My Slack Channel
        type:
          enum:
            - slack
            - telegram
            - discord
            - webhook
            - pagerduty
            - email
            - incidentio
          type: string
          example: slack
        enabled:
          type: boolean
          example: true
        connected:
          type: boolean
          description: >-
            Whether the channel is ready to receive deliveries. Always true
            except for a telegram channel that has not yet linked a chat.
          example: true
        created_at:
          type: string
          example: '2026-05-14T12:00:00.000Z'
        params:
          type: object
          description: Type-specific channel parameters.
          additionalProperties: true
          example:
            webhook_url: https://hooks.slack.com/services/T00/B00/xxxx
        deleted_at:
          type: string
          nullable: true
          description: Soft-delete timestamp. Null while the channel is active.
          example: null
        updated_at:
          type: string
          example: '2026-05-14T12:00:00.000Z'
      required:
        - id
        - workspace_id
        - name
        - type
        - enabled
        - connected
        - created_at
        - updated_at
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: API Key
      description: 'Use Authorization: Bearer <api-key>'
      type: http

````