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

# List email channels

> Returns safe email channel metadata. Mailbox credentials, routing secrets and provider URLs are excluded.

Required scope: `channels:read`. Required product: `desk`.



## OpenAPI

````yaml /openapi.json get /api/v1/channels/email
openapi: 3.0.1
info:
  title: Cconnect Customer API
  description: >-
    Company-scoped REST API for Cconnect Desk and Chat. Bearer credentials are
    issued by your company administrator. Public documentation does not grant
    data access. Operations require CustomerApi:Enabled on the API deployment.
  contact:
    name: Cconnect
    url: https://cconnect.online
  version: 1.0.0
servers:
  - url: https://cconnect.online
    description: Cconnect API server (separate from developers.cconnect.online)
security:
  - CustomerBearer: []
externalDocs:
  description: Cconnect developer portal
  url: https://developers.cconnect.online
paths:
  /api/v1/channels/email:
    get:
      tags:
        - Channels
      summary: List email channels
      description: >-
        Returns safe email channel metadata. Mailbox credentials, routing
        secrets and provider URLs are excluded.


        Required scope: `channels:read`. Required product: `desk`.
      operationId: ListEmailChannels
      parameters:
        - name: page
          in: query
          description: Page number (1–1000).
          schema:
            maximum: 1000
            minimum: 1
            type: integer
            default: 1
        - name: per_page
          in: query
          description: Results per page (1–100).
          schema:
            maximum: 100
            minimum: 1
            type: integer
            default: 25
      responses:
        '200':
          description: OK
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiEmailChannelApiList'
        '400':
          description: Bad Request
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '403':
          description: Forbidden
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '413':
          description: Content Too Large
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '429':
          description: Too Many Requests
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            Retry-After:
              description: Seconds until a retry is allowed.
              schema:
                type: integer
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '503':
          description: Service Unavailable
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ApiEmailChannelApiList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ApiEmailChannel'
        meta:
          $ref: '#/components/schemas/ApiPagination'
      additionalProperties: false
    ApiErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ApiError'
        request_id:
          type: string
      additionalProperties: false
    ApiEmailChannel:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        direction:
          type: string
        support_address:
          type: string
        enabled:
          type: boolean
      additionalProperties: false
    ApiPagination:
      type: object
      properties:
        page:
          type: integer
          format: int32
        per_page:
          type: integer
          format: int32
        has_more:
          type: boolean
      additionalProperties: false
    ApiError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        field:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    CustomerBearer:
      type: http
      description: >-
        Company-owned API token. Supply Authorization: Bearer
        YOUR_CCONNECT_API_TOKEN. Never use provider tokens or member passwords.
        Tokens are shown only once when created.
      scheme: bearer
      bearerFormat: Cconnect API token

````

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