---
title: "Handles Slack Events API webhooks for app mentions"
method: POST
path: "/slack/events"
tags: ["slack"]
---

# Handles Slack Events API webhooks for app mentions

`POST /slack/events`

This endpoint receives events from Slack when users mention @structify.
It handles URL verification challenges and app mention events.
Requires proper authentication via StructifyUser - no fake users created.

## Request body

- union
  - object
    - `challenge` string, required
    - `token` string, nullable
    - `type` 'url_verification', required
  - object
    - `api_app_id` string, nullable
    - `authed_users` string[], nullable
    - `event` SlackEvent, required
      - `channel` string, required
      - `channel_type` string, nullable
      - `client_msg_id` string, nullable
      - `event_ts` string, nullable
      - `files` SlackFile[], nullable
        - `filetype` string, nullable
        - `id` string, required
        - `mimetype` string, nullable
        - `name` string, required
        - `url_private` string, nullable
        - `url_private_download` string, nullable
      - `team` string, nullable
      - `text` string, required
      - `thread_ts` string, nullable
      - `ts` string, required
      - `type` 'app_mention', required
      - `user` string, required
    - `event_context` string, nullable
    - `event_id` string, required
    - `event_time` integer, nullable
    - `team_id` string, required
    - `type` 'event_callback', required

## Response `200`

Event processed successfully

- union
  - SlackChallengeResponse
    - `challenge` string, required
  - SlackEventResponse
    - `message` string, nullable
    - `ok` boolean, required

## Changes

- **2026-01-27** `8d1740b13e31` — 2 breaking
  - the request property `oneOf[subschema #2]/event_id` became not nullable
  - the request property `oneOf[subschema #2]/event_id` became required

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/slack/events/post.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)