---
title: "POST /v1/comments"
method: POST
path: "/v1/comments"
tags: ["comment"]
deprecated: true
---

# POST /v1/comments

`POST /v1/comments`

> **Deprecated.**

<Warning>

This preview API is deprecated. You should use the [Create thread](https://www.canva.dev/docs/connect/api-reference/comments/create-thread/) API instead.

</Warning>

Create a new top-level comment 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/). A design can have a maximum
of 1000 comments.

## Request body

- CreateCommentRequest
  - `attached_to` CommentObjectInput, required — If the comment is attached to a Canva Design.
    - `type` 'design', required
    - `design_id` string, required — The ID of the design you want to attach this comment to.
  - `message` string, required — The comment message. 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

- CreateCommentResponse
  - `comment` ParentComment, required — Data about the comment, including the message, author, and the object (such as a design) the comment is attached to.
    - `type` 'parent', required
    - `id` string, required — The ID of the comment. You can use this ID to create replies to the comment using the [Create reply API](https://www.canva.dev/docs/connect/api-reference/comments/create-reply/).
    - `attached_to` CommentObject — If the comment is attached to a Canva Design.
      - `type` 'design', required
      - `design_id` string, required — The ID of the design this comment is attached to.
    - `message` string, required — The comment message. This is the comment body shown in the Canva UI. User mentions are shown here in the format `[user_id:team_id]`.
    - `author` User, required — 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 — When the comment or reply was created, as a Unix timestamp (in seconds since the Unix Epoch).
    - `updated_at` integer — When the comment or reply was last updated, as a Unix timestamp (in seconds since the Unix Epoch).
    - `mentions` object, required — The Canva users mentioned in the comment.
    - `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.

## 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)