---
title: "Feishu webhook endpoint"
method: POST
path: "/api/feishu/webhook"
tags: ["Feishu"]
---

# Feishu webhook endpoint

`POST /api/feishu/webhook`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/feishu/webhook`
- Auth: HTTP bearer

Webhook endpoint for receiving Feishu events including:
- URL verification challenges
- Inbound message events
- Automatic message storage to database

## Request body

- union
  - object: URL verification challenge
    - `type` 'url_verification'
    - `challenge` string: Challenge string to echo back
  - object: Message event
    - `schema` string
    - `header` object
      - `event_id` string
      - `event_type` string
      - `create_time` string
      - `token` string
      - `tenant_key` string
      - `app_id` string
    - `event` object
      - `sender` object
        - `sender_id` object
          - `open_id` string
          - `union_id` string
          - `user_id` string
        - `sender_type` string
        - `tenant_key` string
      - `message` object
        - `chat_id` string
        - `chat_type` string
        - `content` string
        - `create_time` string
        - `message_id` string
        - `message_type` string
        - `update_time` string
        - `mentions` object[]
          - `id` object
            - `open_id` string
            - `union_id` string
            - `user_id` string
          - `key` string
          - `name` string
          - `tenant_key` string

## Response `200`

Webhook processed successfully

- union
  - object: Challenge response
    - `challenge` string: Echo of the challenge string
  - object: Event processed response
    - `success` boolean
    - `message` string

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)