Slack Events

curl --request POST \
  --url https://api.example.com/slack/events \
  --header 'X-Slack-Request-Timestamp: <x-slack-request-timestamp>' \
  --header 'X-Slack-Signature: <x-slack-signature>'

{
  "challenge": "<string>"
}

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

Slack Events

curl --request POST \
  --url https://api.example.com/slack/events \
  --header 'X-Slack-Request-Timestamp: <x-slack-request-timestamp>' \
  --header 'X-Slack-Signature: <x-slack-signature>'

{
  "challenge": "<string>"
}

Headers

X-Slack-Request-Timestamp

string

required

Unix timestamp when Slack sent the request

X-Slack-Signature

string

required

HMAC signature for request verification (v0=hash)

X-Slack-Retry-Num

string

Retry attempt number (present on retried events)

Response

Event processed successfully

SlackChallengeResponse
SlackEventResponse

challenge

string

required

Challenge string to echo back to Slack

Get Workflow Run Slack Interactions

⌘I