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

# List messaging channels for agent entry points

> Bidirectional messaging channels (Telegram, WhatsApp, Gmail, Slack, Discord, …) from the server registry, joined with available trigger tools. Use for the agent “Choose messaging channel” picker. Channels whose tools are not seeded/visible are omitted.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/toolkits/messaging-channels
openapi: 3.0.0
info:
  title: Flowra API (API Key Endpoints)
  description: >-
    **Flowra** is an AI-powered platform for building agents, workflows, and
    integrations.


    ### Capabilities

    - **Tools & Toolkits** – Define and group tools for agents and workflows.

    - **Workflows** – Orchestrate steps and automate processes.

    - **Triggers** – Schedule or event-based execution.

    - **Auth & Connections** – OAuth, API keys, and connected accounts.

    - **MCP** – Model Context Protocol server integration.

    - **Knowledge / RAG** – Add files and URLs for retrieval-augmented
    generation.


    ### Authentication

    Use the **x-api-key** header with a project API key to access endpoints that
    support API Key auth. Create and manage API keys in the dashboard under your
    project settings.


    Only endpoints that support API Key authentication via the @ApiKeyEnabled()
    decorator.


    Send x-api-key (required). On multi-tenant endpoints, optionally send
    x-username to act as an external user.
  version: '1.0'
  contact:
    name: Flowra
    url: https://flowra.dev
servers:
  - url: https://flowra.dev
    description: Flowra API
security: []
tags:
  - name: Users
    description: User profile
  - name: External Users
    description: End-user identities inside a project (x-username)
  - name: Auth Configs
    description: OAuth and API key configs for toolkits
  - name: Connected Accounts
    description: OAuth connected accounts and link creation
  - name: Toolkits
    description: List and search toolkits
  - name: Tools
    description: List, execute, and manage tools
  - name: Skills
    description: Browse, create, import, and install skills
  - name: Workflow & Agent
    description: Create, run, and inspect workflows and agents
  - name: Triggers
    description: Schedule and event-based trigger instances
  - name: Chat
    description: Threads and streaming agent runs
  - name: File
    description: Upload, list, and download files
  - name: Knowledge
    description: RAG knowledge collections
  - name: Table
    description: Collections and documents
  - name: Sandbox
    description: Ephemeral and durable code sandboxes
  - name: Browser
    description: Live browser sessions and view
  - name: LLM
    description: List AI models and generate completions
  - name: MCP
    description: MCP server management
  - name: usage
    description: Credit balance and usage ledger for the project API key
paths:
  /api/v1/toolkits/messaging-channels:
    get:
      tags:
        - Toolkits
      summary: List messaging channels for agent entry points
      description: >-
        Bidirectional messaging channels (Telegram, WhatsApp, Gmail, Slack,
        Discord, …) from the server registry, joined with available trigger
        tools. Use for the agent “Choose messaging channel” picker. Channels
        whose tools are not seeded/visible are omitted.
      operationId: ToolkitsController_getMessagingChannels
      responses:
        '200':
          description: Messaging channels retrieved successfully
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/MessagingChannelItemDtoArraySuccessResponse
              example:
                success: true
                message: Operation completed successfully
                data:
                  - label: Telegram
                    inboundTriggerToolSlug: TELEGRAM_SET_WEBHOOK
                    toolkitSlug: telegram
                    replyToolSlugs:
                      - TELEGRAM_SEND_MESSAGE
                    accentColor: '#229ED9'
                    chatTheme: {}
                    toolkit:
                      id: ''
                      slug: ''
                      name: ''
                      logo: ''
                      noAuth: true
                    tool:
                      id: ''
                      slug: ''
                      toolkitSlug: ''
                      description: ''
                      inputParameters: {}
                      outputParameters: {}
                      type: ''
                      popularityScore: 0
                      isDisabled: true
                      isDeprecated: true
                      isProjectTool: true
                      noAuth: true
      security:
        - x-api-key: []
components:
  schemas:
    MessagingChannelItemDtoArraySuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Success status
          example: true
        message:
          type: string
          description: Success message
          example: Operation completed successfully
        data:
          description: Response data
          type: array
          items:
            type: object
            properties:
              label:
                type: string
                example: Telegram
              inboundTriggerToolSlug:
                type: string
                example: TELEGRAM_SET_WEBHOOK
              toolkitSlug:
                type: string
                example: telegram
              replyToolSlugs:
                example:
                  - TELEGRAM_SEND_MESSAGE
                type: array
                items:
                  type: string
              accentColor:
                type: string
                example: '#229ED9'
                description: >-
                  Brand hex for dashboard chat chrome; from the channel
                  definition.
              chatTheme:
                type: object
                description: >-
                  Dashboard chat shell tokens (hex + pattern enum). Same source
                  as accentColor.
              toolkit:
                type: object
                properties:
                  id:
                    type: string
                  slug:
                    type: string
                  name:
                    type: string
                  logo:
                    type: string
                  noAuth:
                    type: boolean
                required:
                  - id
                  - slug
                  - name
              tool:
                type: object
                properties:
                  id:
                    type: string
                  slug:
                    type: string
                  toolkitSlug:
                    type: string
                  description:
                    type: string
                  inputParameters:
                    type: object
                    description: >-
                      JSON Schema for tool inputs. Empty object on list
                      endpoints (e.g. with-tools); hydrate via GET
                      /tools/byId/:id when needed.
                  outputParameters:
                    type: object
                    description: >-
                      JSON Schema for tool outputs. Empty object on list
                      endpoints; hydrate via GET /tools/byId/:id when needed.
                  type:
                    type: string
                    description: 'Tool type: action, webhook, poll'
                  popularityScore:
                    type: number
                  isDisabled:
                    type: boolean
                  isDeprecated:
                    type: boolean
                    description: Whether the tool is deprecated and cannot be executed
                  isProjectTool:
                    type: boolean
                    description: True when tool belongs to current project
                  noAuth:
                    type: boolean
                    description: True when tool does not require authentication
                required:
                  - id
                  - slug
                  - toolkitSlug
                  - description
                  - inputParameters
                  - outputParameters
                  - type
                  - popularityScore
                  - isDisabled
                  - isDeprecated
            required:
              - label
              - inboundTriggerToolSlug
              - toolkitSlug
              - replyToolSlugs
              - toolkit
              - tool
          example:
            - label: Telegram
              inboundTriggerToolSlug: TELEGRAM_SET_WEBHOOK
              toolkitSlug: telegram
              replyToolSlugs:
                - TELEGRAM_SEND_MESSAGE
              accentColor: '#229ED9'
              chatTheme: {}
              toolkit:
                id: ''
                slug: ''
                name: ''
                logo: ''
                noAuth: true
              tool:
                id: ''
                slug: ''
                toolkitSlug: ''
                description: ''
                inputParameters: {}
                outputParameters: {}
                type: ''
                popularityScore: 0
                isDisabled: true
                isDeprecated: true
                isProjectTool: true
                noAuth: true
      required:
        - success
        - message
        - data
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Project API key. Create and manage keys in the dashboard under Project →
        API Keys. Send as header: x-api-key: <your-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.