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

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

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

<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 reply to a comment or suggestion thread on a design.
To reply to an existing thread, you must provide the ID of the thread
which is returned when a thread is created, or from the `thread_id` value
of an existing reply in the thread. Each thread can
have a maximum of 100 replies created for it.

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
- `threadId` string, required

## Request body

- CreateReplyV2Request
  - `message_plaintext` string, required — The comment message of the reply in plaintext. This is the reply comment 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]`.

## Response `200`

OK

- CreateReplyV2Response
  - `reply` Reply, required — A reply to a thread. The `author` of the reply might be missing if that user account no longer exists.
    - `id` string, required — The ID of the reply.
    - `design_id` string, required — The ID of the design that the thread for this reply is attached to.
    - `thread_id` string, required — The ID of the thread this reply is in.
    - `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.
    - `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.
    - `created_at` integer, required — When the reply was created, as a Unix timestamp (in seconds since the Unix Epoch).
    - `updated_at` integer, required — When the reply 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)