# Slack GitHub Action

> the Slack GitHub Action is for sending data to Slack and running commands

[![codecov](https://codecov.io/gh/slackapi/slack-github-action/graph/badge.svg?token=OZNX7FHN78)](https://codecov.io/gh/slackapi/slack-github-action)

Comprehensive documentation is available at [docs.slack.dev/tools/slack-github-action](https://docs.slack.dev/tools/slack-github-action).

Use this GitHub Action to:

- [Send data with a webhook to start a workflow in Workflow Builder](https://docs.slack.dev/tools/slack-github-action/sending-data-webhook-slack-workflow)
- [Send data using a Slack API method and a secret token with required scopes](https://docs.slack.dev/tools/slack-github-action/sending-data-slack-api-method/)
- [Send data as a message with a Slack incoming webhook URL](https://docs.slack.dev/tools/slack-github-action/sending-data-slack-incoming-webhook/)
- [Run Slack CLI commands with a service token](https://docs.slack.dev/tools/slack-github-action/running-slack-cli-commands/)

## Project details

### Versioning

We recommend using the latest version of this Action for the most recent updates and fixes.

Changes are logged in the [release notes](https://github.com/slackapi/slack-github-action/releases) with migration guides available for updating from `@v1` to the [`@v2`](https://github.com/slackapi/slack-github-action/releases/tag/v2.0.0) and [`@v3`](https://github.com/slackapi/slack-github-action/releases/tag/v3.0.0) releases.

### License

This project is licensed under the [MIT license](LICENSE).

### Contributing

All contributions are encouraged! Check out the [contributor's guide](.github/contributing.md) to learn more.