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

# Handle Tiptap Webhook

`POST /_webhooks/tiptap`

## Request

- Base URL: `https://api.isometric.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.isometric.com/_webhooks/tiptap`
- Auth: HTTP bearer

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/isometric-api.md) - [All operations](https://skmtc.dev/isometric/apis/isometric-api/llms.txt) - [OpenAPI document](https://skmtc.dev/isometric/apis/isometric-api/revisions/a2a2a7bdbbcf?raw)