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

# List inboxes

> Return all inboxes for the organization. On ticket create, inbox_id is optional: omit to route to the default inbox (is_default: true), or provide an inbox ID from this list to target a specific mailbox.



## OpenAPI

````yaml https://api.initdesk.com/schema.yaml get /organizations/{organization_id}/inboxes/
openapi: 3.0.3
info:
  title: initdesk Customer API
  version: 1.19.0
  description: OpenAPI documentation for the customer-facing API served by the gateway.
servers:
  - url: https://api.initdesk.com
    description: Customer API gateway
security:
  - IntegrationToken: []
tags:
  - name: Organizations
    description: Organization metadata and context for all other resources.
  - name: Customers
    description: >-
      End users (requesters) scoped to the organization. Tickets reference
      customers by ID.
  - name: Tickets
    description: >-
      Tickets, messages, attachments, search, and statuses. A ticket is the
      conversation container; messages are nested under
      `/tickets/{pk}/messages/`.
  - name: Custom Preset Filters
    description: >-
      Saved ticket search filters scoped to the organization. Integration tokens
      receive organization-shared filters only.
  - name: Inboxes
    description: >-
      Organization mailboxes for routing tickets. Each inbox has an email prefix
      and optional default-inbox flag (is_default: true). On ticket create,
      inbox_id is optional: omit to use the default inbox, or provide an inbox
      ID to target a specific mailbox.
  - name: Tags
    description: Organization-scoped ticket tags with id, name, and optional color.
  - name: Help Center
    description: >-
      Support portal settings, knowledge base collections, articles, and article
      search.
paths:
  /organizations/{organization_id}/inboxes/:
    get:
      tags:
        - Inboxes
      summary: List inboxes
      description: >-
        Return all inboxes for the organization. On ticket create, inbox_id is
        optional: omit to route to the default inbox (is_default: true), or
        provide an inbox ID from this list to target a specific mailbox.
      operationId: list_inboxes
      parameters:
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - in: path
          name: organization_id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedInboxList'
          description: ''
      security:
        - IntegrationToken: []
components:
  schemas:
    PaginatedInboxList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/Inbox'
    Inbox:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          title: Inbox Name
          maxLength: 64
        email_prefix:
          type: string
          pattern: ^[a-zA-Z0-9._%-]+$
          maxLength: 32
        inbox_email_address:
          type: string
          description: >-
            Email-only convenience field. Prefer channel_connections
            (type=email).external_identifier for multi-channel inboxes.
          readOnly: true
        channel_connections:
          type: array
          items:
            $ref: '#/components/schemas/ChannelConnectionRead'
          readOnly: true
        is_default:
          type: boolean
          title: Is Default Inbox
          description: >-
            This inbox will be used as the default (and catch all) for the
            organization.
        enable_auto_reply:
          type: boolean
          title: Auto reply is enabled
          description: Automatically reply to new tickets with a welcome message.
        enable_inactivity_reminders:
          type: boolean
          title: Inactivity reminders are enabled
          description: Send reminder emails to customers when tickets are inactive.
        enable_auto_close_inactive_tickets:
          type: boolean
          title: Auto closing inactive tickets is enabled
          description: Automatically close tickets after a specified period of inactivity.
        customer_max_inactivity_period:
          type: integer
          maximum: 2147483647
          minimum: 0
          title: Tickets will be closed after this many days of inactivity
        customer_inactivity_reminder_period:
          type: integer
          maximum: 2147483647
          minimum: 0
          title: Send reminder email after this many days of inactivity
        signature:
          type: string
          title: Email Signature
          description: This signature will be appended to outgoing emails.
        email_from_name:
          type: string
          description: >-
            Optional custom sender display name for outgoing emails from this
            inbox. Falls back to the organization email from name when unset.
          maxLength: 32
        customer_interaction_style:
          enum:
            - helpdesk
            - conversational
          type: string
          x-spec-enum-id: b8814c0c94798024
          description: >-
            Helpdesk exposes ticket numbers in customer emails and messages;
            conversational keeps interactions natural without ticket references.


            * `helpdesk` - Helpdesk

            * `conversational` - Conversational
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - channel_connections
        - created_at
        - email_prefix
        - id
        - inbox_email_address
        - name
        - updated_at
    ChannelConnectionRead:
      type: object
      description: Read-only channel connection payload (no secrets).
      properties:
        id:
          type: integer
          readOnly: true
        type:
          type: string
          readOnly: true
        external_identifier:
          type: string
          readOnly: true
          description: Display/routing hint (e.g. inbox email address for email channel).
        is_enabled:
          type: boolean
          readOnly: true
        status:
          enum:
            - healthy
            - invalid_token
            - webhook_error
            - template_error
          type: string
          x-spec-enum-id: e9d2451ea5b87583
          readOnly: true
          description: |-
            Operational health of the channel connection.

            * `healthy` - Healthy
            * `invalid_token` - Invalid token
            * `webhook_error` - Webhook error
            * `template_error` - Template error
        config:
          allOf:
            - $ref: '#/components/schemas/ChannelConnectionConfig'
          readOnly: true
          description: >-
            User-facing channel settings. Shape is one of the
            ``ChannelConnectionConfig`` variants in the schema; use top-level
            ``type`` to select it.
      required:
        - config
        - external_identifier
        - id
        - is_enabled
        - status
        - type
    ChannelConnectionConfig:
      oneOf:
        - $ref: '#/components/schemas/TelegramUserConfigRead'
        - $ref: '#/components/schemas/WhatsAppUserConfigRead'
    TelegramUserConfigRead:
      type: object
      description: User-facing settings for a Telegram channel connection.
      properties:
        author_name_display:
          type: boolean
          readOnly: true
        conversation_window_hours:
          type: integer
          maximum: 168
          minimum: 1
          readOnly: true
        reopen_closed_within_window:
          type: boolean
          readOnly: true
      required:
        - author_name_display
        - conversation_window_hours
        - reopen_closed_within_window
    WhatsAppUserConfigRead:
      type: object
      description: User-facing settings for a WhatsApp channel connection.
      properties:
        author_name_display:
          type: boolean
          readOnly: true
        conversation_window_hours:
          type: integer
          maximum: 24
          minimum: 1
          readOnly: true
        reopen_closed_within_window:
          type: boolean
          readOnly: true
        associate_reply_template_name:
          type: string
          readOnly: true
        associate_reply_template_language:
          type: string
          readOnly: true
        associate_reply_template_variables:
          type: array
          items:
            type: string
          readOnly: true
        ticket_created_template_name:
          type: string
          readOnly: true
        ticket_created_template_language:
          type: string
          readOnly: true
      required:
        - associate_reply_template_language
        - associate_reply_template_name
        - associate_reply_template_variables
        - author_name_display
        - conversation_window_hours
        - reopen_closed_within_window
        - ticket_created_template_language
        - ticket_created_template_name
  securitySchemes:
    IntegrationToken:
      type: apiKey
      in: header
      name: X-Initdesk-Token

````