Configuring Slack

Last updated:

|Edit this page

Note - these instructions are for self-hosted PostHog instances only. If you are using PostHog Cloud or have already configured your instance per these instructions, check out our general Slack Integration Docs

PostHog has built in support for sending Slack notifications via Actions or Subscriptions. For self-hosted PostHog instances, a Slack App is required so that Teams can add PostHog to their Slack workspace via the standard Oauth flows.

General configuration

🚧 In addition to the Slack App configuration it is important that the instance SITE_URL is correctly set. This is used by Slack's Oauth flow to ensure that only your instance uses the Slack App.

Creating a Slack App and configuring PostHog to use it is relatively straightforward thanks to Slack's App Template functionality. Visit the Slack section of your instance's Project Settings https://MY_POSTHOG.DOMAIN/project/settings#slack and follow the pre-templated instructions to setup your instance for Slack.

The creation of a Slack App is only needed once per instance. Once setup, each PostHog project can be linked to one Slack Workspace via a simple Add to Slack button in Project Settings. See the general Slack Integration Docs for more information.

Questions?

Was this page useful?

Next article

Runbook

This section contains routine procedures and operations to manage your self-hosted PostHog installations. The runbooks contain procedures to begin, stop, supervise, and debug a PostHog infrastructure. If you're using PostHog Cloud , there's no need to worry about any of this as we handle updating, scaling, and monitoring for you! Upgrading Overview Upgrade notes Migrating To PostHog Cloud To PostHog from Amplitude Services ClickHouse Plugin server Kafka MinIO PostgreSQL Redis Zookeeper

Read next article