v1

latestOpenAPI 3.1.02026-07-26142186376.1 KB
Slack

Slack Events

Receives incoming Slack events (messages, mentions, thread starts).

URL Verification: On first setup, Slack sends a url_verification challenge. The endpoint echoes back the challenge string.

Event Processing: Normal events are acknowledged immediately with {"status": "ok"} and processed in the background. This prevents Slack's 3-second retry timeout.

Retry Handling: Events with X-Slack-Retry-Num header are duplicates and return 200 without reprocessing.

Setup: Configure this URL in your Slack App under Event Subscriptions > Request URL.

See the setup guide for creating a Slack App or use the manifest for quick setup.

post/slack/events

Headers

X-Slack-Request-Timestampstring required

Unix timestamp when Slack sent the request

X-Slack-Signaturestring required

HMAC signature for request verification (v0=hash)

X-Slack-Retry-Numstring

Retry attempt number (present on retried events)

Response

Event processed successfully

OR