Skip to content
Letterhead Letterhead Letterhead Help Center
Admin Tools

Connecting Slack

Edit in CMS

Connect Slack and your team sees when a newsletter is scheduled or sent, without anyone logging in to Letterhead to check.

Letterhead posts a message to the Slack channel you choose when:

  • A newsletter is scheduled. As soon as someone on your team schedules one, a message lands in Slack with a View Newsletter button that opens it in Letterhead. Drafts that are only saved don’t post.
  • A newsletter goes out. When it moves on from being scheduled, Letterhead posts a follow-up, marked Sending while it’s going out and Published once it’s out. This follows the send itself, not the newsletter’s metrics.

Both messages include the newsletter’s title, which channel it belongs to, its publication date and time zone, the audience or segment it went to, and a link to view it in Letterhead. The View Newsletter button needs the newsletter to have a web address, which it gets once it has been previewed, so a newsletter scheduled before it was ever previewed may arrive without the button.

Other events, such as promotion updates and audience changes, don’t post to Slack.

  • A company administrator connects Slack, from the company’s settings. The Slack card doesn’t appear for other roles. Once it’s connected, every newsletter in every group in your company posts to the same Slack channel; there’s no per-group or per-newsletter setting.
  • You need permission to add an app to your Slack workspace. Many workspaces limit app installs to Slack admins or ask for an admin’s approval. If that’s you, ask your Slack admin to install the Letterhead app or approve your request.
  • Your browser must allow pop-ups from app.tryletterhead.com, because Slack’s sign-in opens in a new window.
  1. In your company workspace, go to Settings → Integrations and find the Slack card (“Connect your Slack workspace to receive notifications”).
  2. Click Connect to Slack. Slack’s sign-in opens in a new window.
  3. Sign in if you need to, and choose the Slack workspace your team uses.
  4. Choose the Slack channel Letterhead should post to. Every message goes to this one channel, so a dedicated newsletter operations channel usually works better than a general one.
  5. Click Allow. You’re taken back to Letterhead, and the card shows Connected to your workspace name.

To check it, schedule a test newsletter (or wait for the next real one) and look for the message in the channel you picked. It arrives within a few seconds.

In Settings → Integrations, open the Slack card and click Disconnect. Messages stop straight away.

Disconnecting also revokes Letterhead’s access to your Slack workspace, so Letterhead can’t post there again until you reconnect. The Letterhead app may still appear in your workspace’s list of installed apps; your Slack admin can remove it there if you’d like it gone.

If someone removes the Letterhead app on the Slack side without disconnecting in Letterhead, Letterhead can no longer deliver messages and emails your team’s administrator to say so. Reconnect from Settings → Integrations to start the messages again.

If Letterhead says it couldn’t start or finish the Slack connection, try again in a minute; that usually means Slack’s sign-in service didn’t answer. If it keeps happening, or the Slack card is missing even though you’re a company administrator in your company settings, contact support and we’ll sort it out. Want Slack to cover more events? Tell us.

Still can’t find what you need? Contact support.