> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Comment

Add a comment to a post.

## Behavior

* Comments are limited to **200 characters**.
* A post holds up to **500 comments**.
* Commenting is blocked on moderated posts and on private posts you do not own.
* Any `@username` in the comment sends that user a mention notification.

## Examples

```bash theme={null}
curl -X POST "https://relay.snipp.gg/comment" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shareCode": "AbCd1234", "text": "Nice shot!"}'
```

## Responses

Returns the created comment plus the post's full updated comment list.

```json theme={null}
{
  "comment": {
    "id": "00000000-0000-4000-8000-000000000000",
    "body": "Nice shot!",
    "userId": "123456789012345678",
    "createdAt": "2026-05-03T12:00:00Z",
    "username": "playerone",
    "nickname": "Player One",
    "avatar": "https://i.snipp.gg/avatars/123456789012345678/avatar.png",
    "isVerified": false,
    "plus": true,
    "likes": 0,
    "liked": false
  },
  "comments": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "body": "Nice shot!",
      "userId": "123456789012345678",
      "createdAt": "2026-05-03T12:00:00Z",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/avatar.png",
      "isVerified": false,
      "plus": true,
      "likes": 0,
      "liked": false
    }
  ]
}
```