---
title: "POST /v1/designs/{designId}/comments"
method: POST
path: "/v1/designs/{designId}/comments"
tags: ["comment"]
---

# POST /v1/designs/{designId}/comments

`POST /v1/designs/{designId}/comments`

<Warning>
This API is currently provided as a preview. Be aware of the following:
- There might be unannounced breaking changes.
- Any breaking changes to preview APIs won't produce a new [API version](https://www.canva.dev/docs/connect/versions/).
- Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.
</Warning>

Creates a new comment thread on a design.
For information on comments and how they're used in the Canva UI, see the
[Canva Help Center](https://www.canva.com/help/comments/).

## Path parameters

- `designId` string, required

## Request body

- CreateThreadRequest
  - `message_plaintext` string, required — The comment message in plaintext. This is the comment body shown in the Canva UI. You can also mention users in your message by specifying their User ID and Team ID using the format `[user_id:team_id]`. If the `assignee_id` parameter is specified, you must mention the assignee in the message.
  - `assignee_id` string — Lets you assign the comment to a Canva user using their User ID. You _must_ mention the assigned user in the `message`.

## Response `200`

OK

- CreateThreadResponse
  - `thread` Thread, required — A discussion thread on a design. The `type` of the thread can be found in the `thread_type` object, along with additional type-specific properties. The `author` of the thread might be missing if that user account no longer exists.
    - `id` string, required — The ID of the thread. You can use this ID to create replies to the thread using the [Create reply API](https://www.canva.dev/docs/connect/api-reference/comments/create-reply/).
    - `design_id` string, required — The ID of the design that the discussion thread is on.
    - `thread_type` union, required — The type of the discussion thread, along with additional type-specific properties.
      - object — A comment thread.
        - `type` 'comment', required
        - `content` CommentContent, required — The content of a comment thread or reply.
          - `plaintext` string, required — The content in plaintext. Any user mention tags are shown in the format `[user_id:team_id]`.
          - `markdown` string — The content in markdown. Any user mention tags are shown in the format `[user_id:team_id]`
        - `mentions` object, required — The Canva users mentioned in the comment thread or reply.
        - `assignee` User — Metadata for the user, consisting of the User ID and display name.
          - `id` string, required — The ID of the user.
          - `display_name` string — The name of the user as shown in the Canva UI.
        - `resolver` User — Metadata for the user, consisting of the User ID and display name.
          - `id` string, required — The ID of the user.
          - `display_name` string — The name of the user as shown in the Canva UI.
      - object — A suggestion thread.
        - `type` 'suggestion', required
        - `suggested_edits` SuggestedEdit[], required
          - union — The type of the suggested edit, along with additional type-specific properties.
            - object — A suggestion to add some text.
              - …
            - object — A suggestion to delete some text.
              - …
            - object — A suggestion to format some text.
              - …
        - `status` 'open' | 'accepted' | 'rejected', required — The current status of the suggestion.
    - `author` User — Metadata for the user, consisting of the User ID and display name.
      - `id` string, required — The ID of the user.
      - `display_name` string — The name of the user as shown in the Canva UI.
    - `created_at` integer, required — When the thread was created, as a Unix timestamp (in seconds since the Unix Epoch).
    - `updated_at` integer, required — When the thread was last updated, as a Unix timestamp (in seconds since the Unix Epoch).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)