# Browse channel types

Lists the available channel type templates with optional filtering. Use this to discover which integrations are available and what authentication and configuration each requires before creating a channel.

Request:
query.category       - Filter by channel category: ORIGIN (content source systems such as Box, SharePoint, or S3), OBSERVATION (systems monitored for engagement events such as Instagram or a website), or DELIVERY (destination systems to push content to).
query.enabled        - When true, returns only types that are currently available for use. When false, returns only types that are not yet enabled.
query.hasInstance   - When true, returns only types for which the organization already has at least one configured channel.
pagination           - Optional pagination cursor and page size.

Response:
channelTypes   - List of channel types, each including its name, description, authentication method, logo, category, and whether it supports real-time webhook sync.
pageCursor     - Opaque cursor for the next page. Absent when no further results exist.

Endpoint: POST /api/v1/channel/list-channel-types
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `query` (object)

  - `query.category` (array)
    Enum: 0, 1, 2, 3

  - `query.enabled` (boolean)

  - `query.hasInstance` (boolean)

  - `pagination` (object)

  - `pagination.pageCursor` (string)
    Rule data fields

  - `pagination.maxSize` (integer)

## Response 200 fields (application/json):

  - `channelTypes` (array)

  - `channelTypes.id` (string)
    Rule data fields

  - `channelTypes.isRealtimeSync` (boolean)

  - `channelTypes.name` (string)
    Rule data fields

  - `channelTypes.description` (string)
    Rule data fields

  - `channelTypes.category` (integer)
    Enum: 0, 1, 2, 3

  - `channelTypes.groupName` (string)
    Rule data fields

  - `channelTypes.logo` (string)
    Rule data fields

  - `channelTypes.enabled` (boolean)

  - `channelTypes.auth` (integer)
    Enum: 0, 1, 2, 3, 4

  - `channelTypes.authDescription` (any)

  - `channelTypes.setupDescription` (object)

  - `channelTypes.setupDescription.params` (array)

  - `channelTypes.setupDescription.params.label` (string)
    Rule data fields

  - `channelTypes.setupDescription.params.value` (string)
    Rule data fields

  - `channelTypes.setupDescription.params.type` (integer)
    Enum: 0, 1, 2, 3, 4

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)