---
title: "Handle Tiptap Webhook"
method: POST
path: "/_webhooks/tiptap"
---

# Handle Tiptap Webhook

`POST /_webhooks/tiptap`

Receive collaboration webhook events from Tiptap Cloud.

Currently we only act on the first comment in a thread (i.e. a new thread being created)
and post a Slack notification.

## Headers

- `x-client-secret` string, nullable — A secret token identifying the client connecting to the API

## Request body

- TiptapWebhookEvent
  - `trigger` string, required
  - `name` string
  - `thread` union
    - TiptapThread
      - `id` string, required
      - `comments` TiptapCommentData[]
        - `id` string, required
        - `createdAt` string, nullable
        - `updatedAt` string, nullable
        - `content` string, nullable
        - `data` TiptapCommentUserData
          - `userName` string, nullable
          - `userAvatar` string, nullable
    - TiptapCommentData[]
      - `id` string, required
      - `createdAt` string, nullable
      - `updatedAt` string, nullable
      - `content` string, nullable
      - `data` TiptapCommentUserData
        - `userName` string, nullable
        - `userAvatar` string, nullable
  - `comment` TiptapCommentData
    - `id` string, required
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `content` string, nullable
    - `data` TiptapCommentUserData
      - `userName` string, nullable
      - `userAvatar` string, nullable
  - `appName` string
  - `user` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/isometric/apis/fastapi.md) · [All operations](https://skmtc.dev/isometric/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/isometric/fastapi/revisions/d7235b3750b2/schema)