How can I set up the Slack integration?

The Slack integration is the fastest way for your team to see when a letter is scheduled or sent without anyone having to log into Letterhead to check.

What you’ll get in Slack

When you connect Slack, Letterhead posts a message to your chosen Slack channel for each of these events:

• A newsletter is scheduled. As soon as someone on your team schedules a letter, a message lands in Slack with the letter’s title, channel, publication date and time, and audience — plus a View Newsletter button that opens the letter in Letterhead.
• A newsletter goes out. When the letter moves on from being scheduled, Letterhead posts a follow-up message so your team knows it’s on its way — marked Sending while it’s going out, and Published once it’s out.

Both messages include:

• The newsletter’s title
• Which channel it belongs to
• Publication date and timezone
• The audience or segment it was sent to
• A direct link to view the letter in Letterhead

Other events — promotion campaign updates, audience changes — aren’t part of the current Slack integration. They’re on the roadmap (see “What’s coming” at the bottom).

Who can connect Slack

The Slack integration is configured at the company level by an administrator. Once it’s connected, every channel and every organization under that company posts to the same Slack workspace. There’s currently no per-organization or per-newsletter override.

You’ll also need two pieces of access on the Slack side:

• Permission to add an app to your Slack workspace. Many Slack workspaces restrict app installs to workspace admins or require admin approval.
• Permission to pick which Slack channel the notifications post to. You’ll choose this during the connection flow.

If you don’t have those Slack permissions, ask whoever administers your Slack workspace to install the Letterhead app for you, or to approve your install request.

How to connect

Step 1: Open Integrations

From your company workspace, click Settings → Integrations. You’ll see a grid of available integration tiles. Find the Slack Integration tile — the description reads “Connect your Slack workspace to receive notifications.”

If you don’t see the Slack tile in Settings → Integrations, check that you’re signed in as a company administrator and looking at your company settings — connecting Slack is a company administrator’s job, so the tile won’t be there for other roles.

Step 2: Click Connect to Slack

Click the Connect to Slack button on the Slack tile. A new browser window opens to Slack’s OAuth authorization page.

If nothing happens when you click, your browser may be blocking the popup. Allow popups for app.tryletterhead.com and try again.

Step 3: Approve the connection in Slack

Slack asks you to sign in (if you’re not already) and then asks which Slack workspace you want to connect Letterhead to. Pick the workspace your team uses.

Slack then asks you to pick the channel where Letterhead’s notifications should post. This is the channel that will receive every scheduled-letter and letter-going-out message from Letterhead — pick carefully. We’d recommend a dedicated newsletter operations channel rather than a general team channel.

Once you click Allow in Slack, you’re redirected back to Letterhead. The integration tile updates to show Connected to [your workspace name].

Step 4: Test it

Schedule a test newsletter — or wait for the next real scheduled send — and confirm the message lands in the Slack channel you picked. The message should appear within a few seconds of the schedule action.

How to disconnect

In Settings → Integrations, find the Slack tile (which now shows “Connected to [workspace name]”). Click Disconnect. The integration is removed immediately and notifications stop. No further Slack messages will be sent until you reconnect.

Disconnecting revokes Letterhead’s access to your Slack workspace at the same time — it isn’t only a Letterhead-side change, so Letterhead can’t post to your workspace again until you reconnect. The Letterhead app may still be listed among your workspace’s installed apps; if you’d like it gone from that list too, your workspace admin can remove it on the Slack side.

Troubleshooting

The Slack tile isn’t showing in Settings → Integrations. Slack is available to every account, so this is usually about where you’re looking or what you’re signed in as. Confirm you’re in your company settings rather than an organization’s, and that your own account is a company administrator — the tile doesn’t appear for other roles. If both are right and it’s still missing, refresh the page or sign out and back in to clear a stale session, then contact support if it hasn’t appeared.

I clicked Connect to Slack and nothing happened. Your browser blocked the popup. Allow popups for app.tryletterhead.com and click again.

I see “Failed to initiate Slack connection.” This usually means Letterhead couldn’t reach Slack’s authorization service. Try again in a minute. If it persists, contact support.

The connection went through but I’m not getting messages in Slack. A few things to check:

• Confirm you’re looking at the same Slack channel you picked during the connection flow. The notifications post only to that one channel.
• Make sure the letter you’re expecting a message about was actually scheduled (not just saved as a draft). Drafts don’t fire notifications.
• The follow-up message lands when the letter’s status changes as it goes out, not when its metrics finish computing — so don’t wait on numbers to appear before expecting it.

A Slack message looks broken or doesn’t show the View Newsletter button. The View Newsletter button only appears if Letterhead has a valid public URL for the letter. For most letters this is automatic, but very early-draft letters that have never been previewed may not yet have a public URL. Once the letter has been previewed once, the URL exists and future notifications include the button.

I keep getting an email saying a Slack webhook failed. Letterhead emails the team administrator when it can’t deliver a notification to Slack — typically because the integration was disconnected on the Slack side (the app was removed from the workspace) without being disconnected in Letterhead. Reconnect from Settings → Integrations to clear the failure state.

What’s coming

A few things are planned for the Slack integration but not yet available:

• Per-event channel routing — sending different event types to different Slack channels (e.g., scheduled-letter messages to #newsletter-ops, letter-going-out messages to #content-team).
• Notification preferences — controlling which events fire to Slack at the company level.
• More event types — promotion campaign updates and audience changes are on the roadmap.
• Per-organization overrides — letting different organizations under the same company route to different Slack workspaces.

None of these are available today. If any of them would unblock a real use case for you, request a feature and we’ll log it.

---

Still stuck? Contact support and we’ll help you get connected.