---
search:
  tags:
    - Webhook events
    - POST
    - Webhook
seo:
  description: >-
    Kick alerts - the same shape as the twitch.* events with platform: "kick",
    forwarded… Reference for the POST kick.follow webhook in the TipPage
    Developer API.
sidebar:
  label: kick.* (follow, sub, resub, gift_sub, kicks)
  badge: POST
title: kick.* (follow, sub, resub, gift_sub, kicks)
type: openapi-operation
---
Kick alerts - the same shape as the `twitch.*` events with `platform: "kick"`, forwarded before the filter like them (per-overlay alert settings do not gate it). Types: `kick.follow`, `kick.sub`, `kick.resub`, `kick.gift_sub`, `kick.kicks`. Kick subscriptions carry no tier (`tier` is always `"1"`). `kick.kicks` is Kick's paid gift - the counterpart of a cheer - with `kicks` (the amount), `gift_name` and the viewer's `kicks_message`.

`POST kick.follow`

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

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

- `id` (string, required) — Unique event id.
- `type` (string, 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` (TwitchEventData, required) — Platform alert payload (\`twitch.\*\` and \`kick.\*\` events). \`platform\`, \`user\_name\` and \`user\_login\` are always present; the rest depend on the event type.

Payload example:

```json
{
  "id": "evt_9f1e2d3c4b5a6978",
  "type": "kick.follow",
  "created": "2019-08-24T14:15:22Z",
  "actor": {
    "type": "chat",
    "user_id": null,
    "platform": "twitch",
    "platform_id": "123456789",
    "login": "modname",
    "display_name": "ModName"
  },
  "data": {
    "event_id": "string",
    "platform": "twitch",
    "user_name": "string",
    "user_login": "string",
    "profile_image_url": "string",
    "message": "string",
    "tier": "string",
    "months": 0,
    "sub_message": "string",
    "paired_event_id": "string",
    "continuing": true,
    "total": 0,
    "is_anonymous": true,
    "gift_recipients": [
      "string"
    ],
    "bits": 0,
    "viewers": 0,
    "kicks": 0,
    "gift_name": "string",
    "kicks_message": "string"
  }
}
```

**Responses**

- `200` — Return any 2xx quickly.
