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

# Manage Custom Fields

> List the company's contact custom fields. For `select` fields, the available options are returned inline.



## OpenAPI

````yaml GET /settings/custom-fields/
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /settings/custom-fields/:
    get:
      tags:
        - settings
      summary: List Custom Fields
      description: >-
        List the company's contact custom fields. For `select` fields, the
        available options are returned inline.
      operationId: settings_custom_fields_retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CustomFieldListItem'
          description: ''
      security:
        - jwtAuth: []
components:
  schemas:
    CustomFieldListItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        label:
          type: string
        field_type:
          type: string
          description: '`text`, `number`, `date`, `select`, etc.'
        description:
          type: string
        options:
          type: array
          items:
            type: object
            additionalProperties: {}
          description: Empty unless `field_type=select`.
        created_at:
          type: string
          format: date-time
      required:
        - created_at
        - description
        - field_type
        - id
        - label
        - name
        - options
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````