---
title: "Slack Events"
method: POST
path: "/integration/slack/events"
---

# Slack Events

`POST /integration/slack/events`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/integration/slack/events`
- Auth: none declared. Required headers: `x-slack-request-timestamp`, `x-slack-signature`

Slack's Events API request URL. Any error response makes Slack retry.

## Headers

- `x-slack-request-timestamp` integer, required
- `x-slack-signature` string, required

## Request body

- union
  - SlackUrlVerification
    - `type` 'url_verification', required
    - `challenge` string, required
  - SlackEventCallback
    - `type` 'event_callback', required
    - `team_id` string, required
    - `event` SlackAppMention, required
      - `type` 'app_mention', required
      - `channel` string, required
      - `ts` string, required
      - `bot_id` string, nullable

## Response `200`

Successful Response

- SlackUrlVerificationResponse
  - `challenge` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `f723e951cc0b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/integration/slack/events/post.md)

---

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