# Create user comment

> Creates a new user comment

`POST https://api.light.inc/v1/user-comments`

## Note

resourceId is the id of the record being commented on (any record type; there is no resourceType ), and it is not validated — a wrong id is accepted silently. content is stored and returned verbatim with no length limit and no mention syntax. createdBy is always the caller; for an API key that is the key's service-account id.

## Authorization

- API key
- Bearer token

See https://light.inc/docs/getting-started/authentication.

## Request body

`application/json;charset=UTF-8`


```json
{
  "resourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "content": "string"
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders, and fields that exclude each other are all shown. Do not send it unchanged.

## Response


```json
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "content": "string",
  "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders.

## Code

```bash
curl -X POST "https://api.light.inc/v1/user-comments" \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "content": "string"
}'
```

---

Full page: https://light.inc/docs/api-reference/v1--user-comments/create-user-comment · Index: https://light.inc/docs/llms.txt
