HumanLayer Docs

Slack integration ​

Connect Slack to send HumanLayer task artifact updates into the channels where your team already works.

What Slack automations do ​

A Slack automation sends selected events for selected users to a single Slack channel.

Slack automation diagram

Use one automation when one channel should receive one set of updates. Create multiple automations when different teams need different event types, owners, or channels.

Before you start ​

  • You must be an organization admin in HumanLayer.
  • Your Slack workspace must allow you to install apps or approve the HumanLayer app.
  • To notify private channels, invite the HumanLayer Slack app to each private channel after connecting.

Connect Slack ​

  1. Open HumanLayer in the browser.
  2. Go to Settings.
  3. In Integrations, find Slack.
  4. Click Connect Slack.
  5. Approve the Slack installation and return to HumanLayer.
  6. Confirm Slack shows as Connected.

If another admin needs to complete the installation, click Copy handoff URL and send the link to them.

Create an automation ​

  1. In Settings -> Integrations -> Slack, confirm Slack notifications are enabled.
  2. In Notification automations, enter an automation name.
  3. Choose the destination Slack channel.
  4. Choose the HumanLayer events that should post to Slack.
  5. Optionally filter by artifact owner.
  6. Click Create automation.

Event types ​

Slack automations can notify when HumanLayer creates or updates collaboration artifacts:

  • Design discussion created
  • PRD created
  • TDD created
  • Outline created
  • Comment created

Channel access ​

Public channels are available after Slack is connected. For private channels, invite the HumanLayer app from Slack:

text
/invite @HumanLayer

Then return to HumanLayer and refresh the channel picker.

Troubleshooting ​

  • If no channels appear, confirm the Slack app has channel access and refresh the channel list.
  • If a private channel is missing, invite the HumanLayer app to that channel.
  • If Slack shows Needs Reconnection, click Reconnect Slack and approve the app again.
  • If notifications do not post, confirm the automation is enabled and the selected event and owner filters match the artifact activity.