# Slack webhooks

Slack webhooks, in the Events API sense, are signed HTTP POSTs Slack sends to your app's Request URL when something happens in a workspace, and they run the opposite way to incoming webhooks, which post messages into a channel.

These pages cover the Events API, which Slack uses to send events to your app. To post messages into a channel, see [incoming webhook limits](/webhooks/slack/guide-duplicates-ordering-retries-timeouts#other-limits) or [how to send external webhooks to Slack](/webhooks/platforms/how-to-receive-and-replay-external-webhooks-in-slack-with-hookdeck).

Agent skill: `npx skills add hookdeck/webhook-skills --skill slack-webhooks` ([details](https://hookdeck.com/webhooks/slack/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Slack's official docs](https://docs.slack.dev/reference/objects/event-object/).

[Overview](https://hookdeck.com/webhooks/slack) · [Webhook events (91)](https://hookdeck.com/webhooks/slack/events) · [MCP events](https://hookdeck.com/webhooks/slack/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/slack/verify) · [Production guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/slack/skill)

## Key facts

| Fact | Value | Source |
|---|---|---|
| Signature header | `X-Slack-Signature` Format: v0=<hex> | [Slack docs](https://docs.slack.dev/authentication/verifying-requests-from-slack) |
| Scheme | `HMAC-SHA256` | [Slack docs](https://docs.slack.dev/authentication/verifying-requests-from-slack) |
| Signed material | `v0:{timestamp}:{raw body}` The literal v0, the X-Slack-Request-Timestamp value and the request body as sent, joined with colons. | [Slack docs](https://docs.slack.dev/authentication/verifying-requests-from-slack) |
| How events are identified | `event.type field in the body` | [Slack docs](https://docs.slack.dev/apis/events-api) |
| Body format | `JSON` Content type: application/json. | [Slack docs](https://docs.slack.dev/apis/events-api) |
| Send timestamp | `X-Slack-Request-Timestamp` Reject deliveries older than 5 minutes. | [Slack docs](https://docs.slack.dev/authentication/verifying-requests-from-slack) |
| URL handshake | `GET or POST: echo the challenge` Answer 200 with the challenge value as text/plain. | [Slack docs](https://docs.slack.dev/apis/events-api/using-http-request-urls) |
| Envelope | `token, team_id, api_app_id, event, type, event_context, event_id, event_time, authorizations, is_ext_shared_channel, context_team_id, context_enterprise_id` | [Slack docs](https://docs.slack.dev/reference/objects/event-object/) |
| Agent skill | `npx skills add hookdeck/webhook-skills --skill slack-webhooks` | [Agent skill →](https://hookdeck.com/webhooks/slack/skill) |

[Verify Slack webhooks](https://hookdeck.com/webhooks/slack/verify)

## How Slack webhooks work

The Events API tells your app about messages, reactions, channel changes and app installs without polling or a long-lived connection. Your app has one Request URL, which receives every event it subscribes to from every workspace that installs it, so any routing happens on your side. Each event is its own JSON POST. Socket Mode delivers the same events over a WebSocket instead, and Slack recommends it for local development and HTTP for production.

The outer `type` is `event_callback` for an event, and `event.type` says what happened, such as `reaction_added`. Two types have no inner event, so read the outer `type` for them: `url_verification` and `app_rate_limited`. You subscribe to names like `message.channels`, but those deliveries carry `event.type: message` and `event.channel_type` says where it was posted. Message changes and deletions arrive as `message` with an `event.subtype`. Payloads have no version field, and Slack says to expect fields you haven't seen before.

## Setting up Slack webhooks

- In your app's settings at api.slack.com/apps, open Event Subscriptions, turn it on and enter your Request URL. Slack only saves the URL once your endpoint answers a `url_verification` POST with HTTP 200 and the `challenge` value. Then choose bot or workspace events.
- Test locally with Socket Mode, which needs no public URL, or through a tunnel. The Slack CLI's `slack run` starts a local server.
- Slack's docs describe no way to resend an event. Log what you receive, and turn on Delayed Events to extend retries.
- To post messages to a channel instead, open Incoming Webhooks in the same settings, turn it on and add a webhook to your workspace.

## Delivery behaviour

- **Timeout:** 3 seconds. respond with an HTTP 2xx; Slack's docs offer no way to extend it. [Guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#timeouts)
- **Retries:** 3 attempts. nearly immediately, after 1 minute and after 5 minutes, or hourly for 24 hours with Delayed Events. [Guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#retries)
- **After repeated failures:** subscriptions disabled. over 95% of attempts failing in 60 minutes, unless the app gets under 1,000 events an hour. [Guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#retries)
- **Ordering:** no general promise. `app_uninstalled` and `tokens_revoked` are documented as possibly out of sequence. [Guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#ordering)

## Known failure modes

1. **An outage disables your event subscriptions.** If over 95% of delivery attempts fail within 60 minutes, Slack temporarily disables your app's event subscriptions and emails its owner. Delivery stays off until you re-enable it in your app's settings, unless the app gets fewer than 1,000 events an hour. [Retries and disabled subscriptions](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#retries)
2. **Slow handlers get duplicate events.** Slack counts a response after 3 seconds as a failure and retries, even if your handler went on to finish the work. Deduplicate on `event_id`, and use `x-slack-retry-reason` to see why a retry was sent. [Handle duplicates](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#duplicates)
3. **A handler switching on message.channels never matches.** `message.channels` is the name you subscribe to, while the delivery's `event.type` is `message`. Switch on `event.type` and read `event.channel_type` to tell public channels, private channels and DMs apart. [Choosing events](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#choosing-events)
4. **Busy workspaces hit the 30,000 event cap.** Event deliveries max out at 30,000 per workspace per app per 60 minutes, and above that Slack sends `app_rate_limited` every minute. That payload has no `event` object, so code reading `event.type` throws on it. [Rate limits](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#other-limits)

From [Hookdeck's Slack guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts).

## Slack webhook best practices

- **[Verify every signature](https://hookdeck.com/webhooks/slack/verify).** Check it on the raw body, and reject timestamps more than five minutes from your clock. The `token` field is deprecated, so don't rely on it.
- **[Respond within 3 seconds](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#timeouts).** Return a 200 and move the work to a queue, because a slow response counts as a failure and is retried.
- **[Deduplicate on event_id](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#duplicates).** Retries repeat a delivery. Record the `event_id` of each event you process and skip the ones you've seen.
- **[Watch for disabled subscriptions](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#retries).** Failing over 95% of attempts in an hour disables your subscriptions until you re-enable them, so make sure someone reads the email.
- **[Route on the right field](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#choosing-events).** Switch on `event.type`, not the subscription name, and check the outer `type` first for the two types with no inner event.
- **[Alert on app_rate_limited](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts#other-limits).** Above 30,000 events per workspace per app per hour, Slack sends this every minute you're limited.

## Common Slack webhook events

### Messages and mentions

- [app_mention](https://hookdeck.com/webhooks/slack/events#app_mention): Message in a conversation mentions your bot user
- [message.channels](https://hookdeck.com/webhooks/slack/events#message.channels): Subscription for public channel messages; `event.type` is `message`
- [message.im](https://hookdeck.com/webhooks/slack/events#message.im): Subscription for direct messages; `event.type` is `message`

### Reactions and members

- [reaction_added](https://hookdeck.com/webhooks/slack/events#reaction_added): User adds an emoji reaction to an item
- [member_joined_channel](https://hookdeck.com/webhooks/slack/events#member_joined_channel): User joins a channel, private channel or group DM
- [team_join](https://hookdeck.com/webhooks/slack/events#team_join): New member joins the workspace

### App lifecycle

- [app_home_opened](https://hookdeck.com/webhooks/slack/events#app_home_opened): User opens a tab in your App Home
- [app_uninstalled](https://hookdeck.com/webhooks/slack/events#app_uninstalled): Your app is fully removed from a workspace
- [tokens_revoked](https://hookdeck.com/webhooks/slack/events#tokens_revoked): Your app's API tokens are revoked

## Events by resource

| Resource | Events | Payloads |
|---|---|---|
| [app](https://hookdeck.com/webhooks/slack/events#resource-app) | 13 | 13 |
| [channel](https://hookdeck.com/webhooks/slack/events#resource-channel) | 11 | 11 |
| [message](https://hookdeck.com/webhooks/slack/events#resource-message) | 11 | 11 |
| [user](https://hookdeck.com/webhooks/slack/events#resource-user) | 9 | 9 |
| [file](https://hookdeck.com/webhooks/slack/events#resource-file) | 7 | 7 |
| [workspace](https://hookdeck.com/webhooks/slack/events#resource-workspace) | 7 | 7 |
| [private_channel](https://hookdeck.com/webhooks/slack/events#resource-private-channel) | 6 | 6 |
| [reaction](https://hookdeck.com/webhooks/slack/events#resource-reaction) | 6 | 2 |
| [shared_channel](https://hookdeck.com/webhooks/slack/events#resource-shared-channel) | 5 | 5 |
| [user_group](https://hookdeck.com/webhooks/slack/events#resource-user-group) | 5 | 5 |

3 more resources. [All 91 events](https://hookdeck.com/webhooks/slack/events)

## In this hub

- [Webhook events](https://hookdeck.com/webhooks/slack/events): Every covered Slack event, with payloads where the registry has them.
- [MCP events](https://hookdeck.com/webhooks/slack/mcp-events): How an agent subscribes to Slack events as MCP events.
- [Verify signatures](https://hookdeck.com/webhooks/slack/verify): Signature facts, verification code and common failures.
- [Production guide](https://hookdeck.com/webhooks/slack/guide-duplicates-ordering-retries-timeouts): Production problems: timeouts, duplicates, ordering and retries, and how to handle them.
- [Agent skill](https://hookdeck.com/webhooks/slack/skill): Install the webhook skill in your coding agent. `npx skills add hookdeck/webhook-skills --skill slack-webhooks`
---

Not affiliated with Slack. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/slack.json) · [Report a correction](https://hookdeck.com/contact)
