> For the complete documentation index, see [llms.txt](https://developers.welcomekit.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.welcomekit.co/candidates-api/create-a-comment.md).

# Comment

This endpoint lets you create new comments for a given candidate\_reference.

{% hint style="info" %}
 This endpoint requires `comments_w`, and `candidates_rw` or `my_candidates_rw` scopes.
{% endhint %}

## comment creation

<mark style="color:green;">`POST`</mark> `https://www.welcomekit.co/api/v1/external/comments`

#### Query Parameters

| Name                                                   | Type   | Description                                    |
| ------------------------------------------------------ | ------ | ---------------------------------------------- |
| candidate\_reference<mark style="color:red;">\*</mark> | string | Candidate reference                            |
| content                                                | string | Comment content (plain text, html or markdown) |

{% tabs %}
{% tab title="200 Success" %}

```
{
  "id":83316,
  "content":"<p>Foo</p>\n",
  "raw_content":"Foo"
}
```

{% endtab %}
{% endtabs %}

Request example

```
curl -X POST "https://www.welcomekit.co/api/v1/external/comments" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer WK_API_KEY" \
    -d @- <<EOF
{
  "candidate_reference": "wttj-d655345409a6097309156b05",
  "content": "Foo"
}
EOF
```