slack-web

Bindings for the Slack web API

https://github.com/MercuryTechnologies/slack-web

LTS Haskell 24.28:2.2.0.0
Stackage Nightly 2026-01-18:2.2.0.0
Latest on Hackage:2.2.0.0

See all snapshots slack-web appears in

MIT licensed by Juan Pedro Villa Isaza, Jade Lovelace <software at lfcode dot ca>, Dennis Hennen
Maintained by Jade Lovelace <software at lfcode dot ca>
This version can be pinned in stack with:slack-web-2.2.0.0@sha256:997e6991fcc2ebbf9089c31a61327799d90dc78474a12bbcf3f677c3c471233e,6955

Module documentation for 2.2.0.0

  • Web
    • Web.Slack
      • Web.Slack.Api
      • Web.Slack.Auth
      • Web.Slack.Chat
      • Web.Slack.Classy
      • Web.Slack.Common
      • Web.Slack.Conversation
      • Web.Slack.Experimental
        • Web.Slack.Experimental.Blocks
          • Web.Slack.Experimental.Blocks.Builder
          • Web.Slack.Experimental.Blocks.Types
        • Web.Slack.Experimental.Events
          • Web.Slack.Experimental.Events.Types
        • Web.Slack.Experimental.RequestVerification
        • Web.Slack.Experimental.Views
      • Web.Slack.Files
        • Web.Slack.Files.Types
      • Web.Slack.Internal
      • Web.Slack.MessageParser
      • Web.Slack.Pager
        • Web.Slack.Pager.Types
      • Web.Slack.Reactions
      • Web.Slack.Types
      • Web.Slack.User
      • Web.Slack.UsersConversations
Used by 1 package in nightly-2026-01-18(full list with versions):
slack-web

Haskell bindings for the Slack web API

Example

> import qualified Web.Slack as Slack

> import qualified Web.Slack.Api as Api

> :set -XOverloadedStrings

> slackConfig <- Slack.mkSlackConfig token

> Slack.apiTest (Slack.slackConfigManager slackConfig) Api.mkTestReq
Right ...

> Slack.apiTest (Slack.slackConfigManager slackConfig) Api.mkTestReq { Api.testReqFoo = Just "bar" }
Right ...

Contributing

This repository provides a flake.nix file which offers pre-commit hooks and haskell-language-server. We use fourmolu for formatting, which is verified in CI.

To use the flake, run nix develop, which will get you cabal and everything else you need to work on slack-web.

Pull requests are welcome!

License

Licensed under the MIT license. See LICENSE.md.

Changes

2.1.1.0

  • #145 Implement conversations.info API method.

    Breaking change: imIsUserDeleted is now Maybe to reflect reality.

  • #146 Implement conversations.join API method.

2.1.0.0 (2025-03-06)

  • #138 Implement views.publish method and App Home tab events.

  • #140 Implement reactions.add method.

    Breaking change: various places in the API using emoji now use an Emoji newtype.

  • #141 Include response_metadata in errors. This is a breaking change since it changes the type of ResponseSlackError and friends to add that field.

  • #142 Make the block builder previously used in the test suite public as an experimental module Web.Slack.Experimental.Blocks.Builder.

    This makes the DSL for specifying messages built with blocks a bit nicer.

  • #143 Add the bot_profile field to messages.

2.0.1.0 (2025-01-09)

  • #136 Bumps the version ranges for dependencies to be compatible with LTS 22.43.

2.0.0.4 (2024-09-15)

  • #135 Improves attachement support by providing clients wih the raw JSON value in case of a parse failure.

2.0.0.3 (2024-08-30)

  • #133 Adds attachment support for message event subscriptions.

2.0.0.2 (2024-08-29)

  • #132 Add support for bot_message event subtype.

2.0.0.0 (2023-10-26)

  • #123 Add support for section fields.

1.6.2.0 (2023-10-24)

  • #127 Add helper for the divider block type.

1.6.1.0 (2022-12-16)

1.6.0.0 (2022-12-14)

Breaking changes

  • usersList now takes a User.ListReq object. You can construct one with data-default’s def function to get the previous behaviour.

New features

  • #120 Add file share event parsing support.

    Increase bounds on pretty-simple to 4.1 to mitigate a bug added in 4.0.

  • #121 Add pagination of users.list

1.5.0.1

  • #119 Fix a typo in rich text decoding.

1.5.0.0

Breaking changes

  • PostMsgRsp uses a Text instead of a String for the ts.
  • PostMsgReq uses Maybe for the text since it is optional if blocks or attachments are provided.

The following fields are now Maybe since they have been found to be absent in some responses:

  • ChannelConversation.channelSharedTeamIds
  • ChannelConversation.channelIsMember
  • ChannelConversation.channelNumMembers

Breaking changes since development versions

  • The SlackBlockSection constructor has a new Maybe field for accessories.

New features

  • chat.update bindings #112
  • users.conversations bindings #109
  • Generic pagination, making new requests easy to paginate #105
  • Expose an Internal module, allowing for new endpoints to be defined without changing slack-web #99
  • Three experimental features:
    • Schemas for the Events API #107
    • Request verification for webhooks #106
    • Support for Blocks including a builder, headers, and accessories #100, #115, #116

Bug fixes

  • Conversation parse errors will pick the variant first, then let it fail. Messages now identify the correct variant and missing fields. #108

Project updates

Mercury now maintains this library.

CI has been rewritten, and a Nix flake is now provided.

We have gathered a fair corpus of sample data from Slack through the course of writing Slacklinker, which has been used to write a new snapshot test suite.

Thanks to Daniel Brice, Dennis Hennen, Claire Violet, Evan Relf, Jake Keuhlen, Rebecca Turner, Matthew Mongeau, and Kevin Tang for their contributions to this release!

0.3.0.1

  • Use Authorization header (44c3cf1)

0.1.0

Methods

New

  • api.test
  • auth.test
  • channels.create
  • chat.postMessage