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

# Create List Column



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#SHAREPOINT_CREATE_LIST_COLUMN
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#SHAREPOINT_CREATE_LIST_COLUMN:
    post:
      summary: Create List Column
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: SHAREPOINT_CREATE_LIST_COLUMN
                parameters:
                  type: object
                  properties:
                    listId:
                      type: string
                      description: >-
                        The list ID to perform the operation on. (example:
                        22e03ef3-6ef4-424d-a1d3-92a337807c30)
                    dataType:
                      type: string
                      description: >-
                        Data Type : Determines what type of data the column
                        stores
                      enum:
                        - boolean
                        - choice
                        - dateTime
                        - number
                        - text
                    allowTextEntry:
                      type: boolean
                      description: >-
                        Allow Text Entry : If true, allows custom values that
                        aren’t in the configured choices. 

                        This field appears only when 'dataType' = 'choice')
                    choices:
                      type: object
                      description: >-
                        Choices : The list of values available for this column.
                        (example: "["red", "blue", "green"]") 

                        This field appears only when 'dataType' = 'choice')
                      properties: {}
                    displayAs:
                      type: string
                      description: >-
                        Display As : How the choices are to be presented in the
                        UX.

                        Available options by dataType:

                        - 'checkBoxes': available when 'dataType' = 'choice'

                        - 'dropDownMenu': available when 'dataType' = 'choice'

                        - 'radioButtons': available when 'dataType' = 'choice'

                        - 'default': available when 'dataType' = 'dateTime'

                        - 'friendly': available when 'dataType' = 'dateTime'

                        - 'standard': available when 'dataType' = 'dateTime'

                        - 'number': available when 'dataType' = 'number'

                        - 'percentage': available when 'dataType' = 'number'
                      enum:
                        - number
                        - percentage
                        - checkBoxes
                        - dropDownMenu
                        - radioButtons
                        - default
                        - friendly
                        - standard
                    format:
                      type: string
                      description: >-
                        Format : Indicates whether the value should be presented
                        as a date only or a date and time. 

                        This field appears only when 'dataType' = 'dateTime')
                      enum:
                        - dateOnly
                        - dateTime
                    maximum:
                      type: string
                      description: |-
                        Maximum : The maximum permitted value. 
                        This field appears only when 'dataType' = 'number')
                    minimum:
                      type: string
                      description: |-
                        Minimum : The minimum permitted value. 
                        This field appears only when 'dataType' = 'number')
                    linesForEditing:
                      type: string
                      description: |-
                        Lines for Editing : The size of the text box. 
                        This field appears only when 'dataType' = 'text')
                    maxLength:
                      type: string
                      description: >-
                        Max Length : The maximum number of characters for the
                        value. 

                        This field appears only when 'dataType' = 'text')
                    textType:
                      type: string
                      description: |-
                        Text Type 
                        This field appears only when 'dataType' = 'text')
                      enum:
                        - plain
                        - richText
                    allowMultipleLines:
                      type: boolean
                      description: >-
                        Allow Multiple Lines : Whether to allow multiple lines
                        of text. 

                        This field appears only when 'dataType' = 'text')
                    displayName:
                      type: string
                      description: 'Display Name : The user-facing name of the column.'
                    apiName:
                      type: string
                      description: >-
                        Api Name : The API-facing name of the column as it
                        appears in the fields on a List Item.
                    description:
                      type: string
                      description: >-
                        Description : Description or acceptance criteria for
                        this epic to be considered complete.
                    defaultValue:
                      type: string
                      description: 'Default Value : The default value for this column.'
                    hidden:
                      type: boolean
                      description: Hidden
                    readOnly:
                      type: boolean
                      description: Read-only
                  required:
                    - listId
                    - dataType
                    - textType
                    - displayName
                    - apiName
                  x-integration: sharepoint
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````