---
search:
  tags:
    - Webhook events
    - POST
    - Webhook
seo:
  description: >-
    Chat moderation acted on a message. One event per enforcement step of the…
    Reference for the POST chat.moderated webhook in the TipPage Developer API.
sidebar:
  label: chat.moderated
  badge: POST
title: chat.moderated
type: openapi-operation
---
Chat moderation acted on a message. One event per enforcement step of the response that ran (a delete, or a timeout or ban), or one `warn` event when the response only posted messages. `feature` names where the match came from (`rule`, `bannedWords`, `links`, `caps`, `emotes`, `symbols`, or `votekick` for a timeout the votekick bot module carried out), `rule` the streamer's named rule when one fired, `matched_term` the phrase that matched. `enforced: false` means the platform-side action failed - on Twitch the bot isn't modded in the channel or lacks the moderator scopes, on Kick the streamer's Kick connection lacks the moderation scopes - and the attempt is still reported so nothing slips by silently. Message text is public chat content. `platform` says which chat it happened in; Kick moderation is enforced through the streamer's own Kick connection.

`POST chat.moderated`

**Webhook.** The API sends this request to your endpoint.

**Payload** (`application/json`)

- `id` (string, required) — Unique event id.
- `type` (any, required)
- `created` (string<date-time>, required)
- `actor` (object | null, required) — Who caused the event. \`null\` for system-originated events (a payment landing, an overlay heartbeat lapsing). Otherwise one of \`user\` (a team member in the dashboard), \`chat\` (a moderator's chat command via the bot), \`api\_key\` (a developer API key), \`oauth\_app\` (an OAuth-connected app), \`overlay\` (the overlay reporting start/finish) or \`bot\`.
- `data` (object, required)

Payload example:

```json
{
  "id": "evt_9f1e2d3c4b5a6978",
  "type": "chat.moderated",
  "created": "2019-08-24T14:15:22Z",
  "actor": {
    "type": "chat",
    "user_id": null,
    "platform": "twitch",
    "platform_id": "123456789",
    "login": "modname",
    "display_name": "ModName"
  },
  "data": {
    "platform": "twitch",
    "action": "warn",
    "enforced": true,
    "duration_seconds": 0,
    "target_user_id": "string",
    "target_login": "string",
    "target_name": "string",
    "feature": "rule",
    "rule": {
      "id": "string",
      "name": "string"
    },
    "matched_term": "string",
    "message": "string",
    "reason": "string"
  }
}
```

**Responses**

- `200` — Return any 2xx quickly.
