---
title: "Create discussion"
method: POST
path: "/sheets/{sheetId}/discussions"
tags: ["discussions"]
---

# Create discussion

`POST /sheets/{sheetId}/discussions`

Creates a new discussion on a sheet. To create a discussion with an attachment please use "multipart/form-data" content type.

## Headers

- `Content-Type` string

## Request body

- DiscussionCreateRequest
  - `comment` CommentText — Comment text object.
    - `text` string — Comment text.

## Response `200`

SUCCESS

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` Discussion
    - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER'
    - `id` number — Discussion ID.
    - `comments` Comment[] — Array of comments in discussion. Only returned if the include query string parameter contains comments.
      - `attachments` Attachment[] — Array of attachments on comments.
        - `id` number — Attachment ID.
        - `parentId` number — The ID of the parent.
        - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
        - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
        - `mimeType` string — Attachment MIME type.
        - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
        - `createdAt` union
          - string, date-time
          - number
        - `createdBy` MiniUser — MiniUser Object
          - `email` string, email
          - `name` string
        - `name` string — Attachment name.
        - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
        - `url` string — Attachment temporary URL (files only).
        - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
      - `createdAt` union
        - string, date-time
        - number
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `discussionId` number — Discussion ID of discussion that contains comment.
      - `id` number — Comment ID.
      - `modifiedAt` union
        - string, date-time
        - number
      - `text` string — Comment body.
    - `commentAttachments` Attachment[] — Array of attachments on discussion comments. Only returned if the include query string parameter contains attachments.
      - `id` number — Attachment ID.
      - `parentId` number — The ID of the parent.
      - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
      - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
      - `mimeType` string — Attachment MIME type.
      - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
      - `createdAt` union
        - string, date-time
        - number
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `name` string — Attachment name.
      - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
      - `url` string — Attachment temporary URL (files only).
      - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
    - `commentCount` number — Number of comments in the discussion.
    - `createdBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `lastCommentedAt` union
      - string, date-time
      - number
    - `lastCommentedUser` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `parentId` number — The ID of the associated row or sheet.
    - `parentType` 'ROW' | 'SHEET' — Type of parent object.
    - `readOnly` boolean — Indicates whether the user can modify the discussion.
    - `title` string — Title automatically created by duplicating the first 100 characters of top-level comment.
  - `version` number, nullable — New version of the sheet. Applicable only for operations which update sheet data.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)