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

# Add a record comment

> Add a system-authored activity comment to an active record.

Add an activity comment to an active record.

Use a developer access key. See [authentication, errors, and rate limits](/api-reference/authentication).

Required scope: `comments:write`.

The record must belong to the key's workspace and must not be archived. The
comment is written as a system activity. Set `actor_display_name` when the
activity should show a source label such as `Website form`; when omitted, Kato
uses the API key's actor identity.

## Parameters

<ParamField path="recordId" type="string" required>
  Active record ID, 1–200 characters.
</ParamField>

<ParamField body="comment" type="string" required>
  Trimmed comment text, 1–10,000 characters.
</ParamField>

<ParamField body="actor_display_name" type="string">
  Optional trimmed activity author label, 1–120 characters.
</ParamField>

## Response

**201** — Returns the created activity ID under `data`.

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "activityId": "activity_example"
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    "https://api.getkato.io/v1/records/$KATO_RECORD_ID/comments" \
    -H "Authorization: Bearer $KATO_API_KEY" \
    -H "Content-Type: application/json" \
    --data '{
    "comment": "A message submitted from the website.",
    "actor_display_name": "Website form"
  }'
  ```
</RequestExample>

The activity is published to realtime subscribers and matching activity
webhooks. It does not send member notifications. A timeout does not prove that
the write failed; inspect the record before retrying.


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Add a comment](/api-reference/raycast/comments-create.md)
- [Objects and records API](/api-reference/objects-and-records.md)
- [Build an automation](/documentation/build-an-automation.md)
- [Authentication and API conventions](/api-reference/authentication.md)