{"id":31970503,"url":"https://github.com/hubspot/slack-client","last_synced_at":"2026-02-18T01:19:15.122Z","repository":{"id":38375507,"uuid":"125078412","full_name":"HubSpot/slack-client","owner":"HubSpot","description":"An asynchronous HTTP client for Slack's web API","archived":false,"fork":false,"pushed_at":"2025-10-06T07:18:44.000Z","size":1525,"stargazers_count":116,"open_issues_count":27,"forks_count":58,"subscribers_count":137,"default_branch":"master","last_synced_at":"2025-10-06T09:27:18.165Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HubSpot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-03-13T16:04:25.000Z","updated_at":"2025-10-04T01:09:09.000Z","dependencies_parsed_at":"2023-01-29T04:31:18.405Z","dependency_job_id":"9d33b563-ea8a-4a1f-b0c9-54b2e10ae2d1","html_url":"https://github.com/HubSpot/slack-client","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/HubSpot/slack-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fslack-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fslack-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fslack-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fslack-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HubSpot","download_url":"https://codeload.github.com/HubSpot/slack-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fslack-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279020649,"owners_count":26086895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-14T19:15:52.026Z","updated_at":"2025-10-14T19:15:55.968Z","avatar_url":"https://github.com/HubSpot.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slack-client \n\n[![license](https://img.shields.io/github/license/HubSpot/slack-client.svg?style=social)](https://github.com/HubSpot/slack-client/blob/master/LICENSE)\n[![GitHub last commit](https://img.shields.io/github/last-commit/HubSpot/slack-client.svg?style=social)](https://github.com/HubSpot/slack-client/commits/master)\n [![Build Status](https://travis-ci.org/HubSpot/slack-client.svg?branch=master)](https://travis-ci.org/HubSpot/slack-client) [![GitHub release](https://img.shields.io/github/release/HubSpot/slack-client.svg)](https://github.com/HubSpot/slack-client/releases) ![Maven metadata URI](https://img.shields.io/maven-central/v/com.hubspot.slack/slack-java-client) \n \n* [Overview](#overview)\n* [Maintenance](#maintenance)\n* [Features](#features)\n* [Usage](#usage)\n* [Setting up Guice](#setting-up-guice)\n* [Using the Client](#using-the-client)\n* [Contributors](#contributors)\n* [License](#license)\n\n## Overview\n\nAn asychronous HTTP client wrapping Slack's [RPC-style web api](https://api.slack.com/web). Provides an extensible API with builder-style parameters and responses, allowing you to focus on your interactions with users, rather than your interactions with Slack. Notably, we:\n\n* Implement [most](#features) of Slack's [web API](https://api.slack.com/web)\n* Actively maintain this project\n* Provide per-method in-memory rate limiting so you don't have to worry about overwhelming slack from a single process\n* Expose highly configurable hooks to allow custom rate limiting, method filtering, and debugging in an extensible way\n\n\n## Breaking Changes\n\n**NOTICE:**\n\nThe original web API method for uploading files to Slack, `files.upload`, is being sunset on March 11, 2025. [See details](https://api.slack.com/changelog/2024-04-a-better-way-to-upload-files-is-here-to-stay)\n\nOn October 18th 2019, Slack will stop supporting the `replies` thread on a `Message` returned from the [`conversations.replies` endpoint](https://api.slack.com/methods/conversations.replies) as well as any places that use `LiteMessage`.\n\nDue to this, we are deprecating `getReplies()` on [`LiteMessage`](https://github.com/HubSpot/slack-client/blob/master/slack-base/src/main/java/com/hubspot/slack/client/models/LiteMessageIF.java)\nIt will return the data as long as Slack still returns it, bue when they stop, we will just return an empty array.\n\nMore context in the [April 2019 changelog](https://api.slack.com/changelog)\n\nYou can continue to use an older version of this client until October 18th, at which time you'll need to upgrade to the latest.\n\n\n## Maintenance\n\nLike most APIs, deprecations and modifications that we'll call \"breaking changes\" will occur on Slack's web API.\nGeneral guidelines on detecting and handling \"breaking changes\" can be found [here](https://github.com/HubSpot/slack-client/blob/master/DEV_README.md)\n\n## Features\n\nWe currently support:\n#### auth\n - auth.test\n - auth.revoke\n#### channels\n - channels.history\n - channels.info\n - channels.kick (kickUserFromChannel)\n - channels.list\n - channels.replies (findReplies)\n#### chat\n - chat.delete\n - chat.getPermalink\n - chat.postEphemeral\n - chat.postMessage\n - chat.update\n - chat.scheduleMessage\n - chat.deleteScheduledMessage\n - chat.scheduledMessages.list\n#### conversations\n - conversations.archive\n - conversations.create\n - conversations.history\n - conversations.info\n - conversations.invite\n - conversations.list\n - conversations.members\n - conversations.open\n - conversations.unarchive\n - conversations.setTopic\n - conversations.setPurpose\n#### dialog\n - dialog.open\n#### files\n - files.upload\n - files.getUploadURLExternal\n - files.completeUploadExternal\n - files.sharedPublicURL\n#### groups\n - groups.kick (kickUserFromGroup)\n - groups.list\n - groups.replies (findReplies)\n#### im\n - im.open\n#### reactions\n - reactions.add\n#### search\n - search.messages\n#### team\n - team.info \n#### usergroups\n - usergroups.create\n - usergroups.disable\n - usergroups.enable\n - usergroups.list\n - usergroups.update\n#### usergroups.users\n - usergroups.users.update\n#### users\n - users.conversations\n - users.info (findUser)\n - users.list\n - users.lookupByEmail\n#### views\n - views.open\n - views.update\n - views.push\n - views.publish\n#### Utility Methods\n - getConversationByName\n - getChannelByName\n#### Migration\n - migration.exchange\n\nWe happily welcome any PRs for APIs that haven't yet been implemented!\n\n## Usage\n\nTo use with Maven-based projects, add the following dependencies::\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.hubspot.slack\u003c/groupId\u003e\n  \u003cartifactId\u003eslack-base\u003c/artifactId\u003e\n  \u003cversion\u003e{latest version}\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.hubspot.slack\u003c/groupId\u003e\n  \u003cartifactId\u003eslack-java-client\u003c/artifactId\u003e\n  \u003cversion\u003e{latest  version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nLatest version can be seen [here, on Maven central](https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.hubspot.slack%22).\n\n### Setting up Guice\n\nInstall the `SlackClientModule` in the Guice module you want to use to talk to slack.\n\n```java\npublic class MyFancyModule extends AbstractModule {\n  @Override\n  protected void configure() {\n    install(new SlackClientModule());\n  }\n}\n```\n\nFinally inject the factory where you want to build the client:\n\n```java\npublic class MySlacker {\n  private final SlackClient slackClient;\n  \n  \n  public MySlacker(\n      SlackWebClient.Factory clientFactory\n  ) {\n    this.slackClient = clientFactory.build(\n        SlackClientRuntimeConfig.builder()\n          .setTokenSupplier(() -\u003e \"your token here\")\n          // ... all your configuration here\n          .build()\n    );\n  }\n  \n  // then just use the client!\n}\n```\n\n### Using the Client\n\nIf you're not familiar with Java 8's `CompletableFuture` API, know that you can transform this client from an asynchronous one to a synchronous one by calling `join` on any of the futures returned. To simplify getting started, we've included an [example module](slack-java-client-examples) with some common tasks to give you a feel for how you can interact with the client.\n\n\n## Contributors\n - [@johnnyleitrim](https://github.com/johnnyleitrim) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=johnnyleitrim)\n - [@kecarroll](https://github.com/kecarroll) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=kecarroll)\n - [@szabowexler](https://github.com/szabowexler) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=szabowexler)\n - [@zklapow](https://github.com/zklapow) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=zklapow)\n - [@wsorenson](https://github.com/wsorenson) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=wsorenson)\n - [@darcatron](https://github.com/darcatron) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=darcatron)\n - [@dylanrb123](https://github.com/dylanrb123) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=dylanrb123)\n - [@stevegutz](https://github.com/stevegutz) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=stevegutz)\n - [@BWehner](https://github.com/BWehner) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=BWehner)\n - [@axiak](https://github.com/axiak) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=axiak)\n - [@andybergon](https://github.com/andybergon) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=andybergon)\n - [@mlr46](https://github.com/mlr46) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=mlr46)\n - [@mindspin311](https://github.com/mindspin311) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=mindspin311)\n - [@Ulya0302](https://github.com/Ulya0302) | [:computer:](https://github.com/HubSpot/slack-client/commits?author=Ulya0302)\n\n## License\n\n    Copyright 2018 HubSpot, Inc.\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhubspot%2Fslack-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhubspot%2Fslack-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhubspot%2Fslack-client/lists"}