---
title: Add a custom bot
description: Create a Slack app from Pyn's manifest so messages come from your own bot name and icon, then paste its bot token into Pyn.
sidebar:
  order: 2
area: integrations
feature: slack
appPath: /settings/integrations/installed
lastVerified: 2026-10-22
version: "2026-10-16"
audience: admin
related:
  - integrations/slack
  - settings/senders
  - flows/automations
intercom:
  - id: "16755898"
    title: Set up a Custom Slack Sender/Slack Bot (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755898-set-up-a-custom-slack-sender-slack-bot-pyn-2
    note: replaces
  - id: "9585758"
    title: Send Slack messages from a service account (Pyn 1)
    url: https://intercom.help/pyn/en/articles/9585758-send-slack-messages-from-a-service-account-pyn-1
    note: "Pyn 1 article, kept for reference"
---

You want messages to come from `@PeopleTeam` rather than from the Pyn Bot or a person. A custom bot is a Slack app you create in your workspace from a manifest Pyn gives you; you paste its bot token into Pyn and it appears as a sender.

## Before you start

- The Slack integration is **Active** under **Settings > Integrations**.
- You, or a Slack workspace administrator working with you, can create apps at `api.slack.com/apps`.

![Installed lists every connected integration; select the Slack tile to open its panel.](https://support.pynhq.com/media/integrations/overview/integrations-installed-list.png)

## Steps

1. In Pyn, open **Settings** in the left navigation, then **Installed** under **Integrations**, and select the **Slack** tile.

2. Open the **...** menu and select **Add custom bot**.

3. Expand **Slack set up** and select **Copy manifest**. The manifest requests `channels:read`, `channels:write.invites`, `chat:write`, `groups:read`, `groups:write.invites` and `im:write` for the bot.

4. In Slack, go to `api.slack.com/apps`, select **Create New App**, then **From a manifest**. Choose the workspace, paste the manifest on the **YAML** tab and finish creating the app. Replace both occurrences of `CHANGEME_Name` with the bot's name.

5. Install the app to the workspace and, under **Basic Information**, set its display name, description and icon.

6. Under **OAuth & Permissions**, copy the **Bot User OAuth Token** (it starts with `xoxb-`).

7. Back in Pyn, paste it into **Bot Token** and select **Add**.

> **Tip:** Invite the bot to each channel it should post to; a bot can post only where it is a member. Replies to the bot's direct messages are visible in the app's own message view in Slack, not in a person's inbox.

## What you should see

The bot appears under **Settings > General > Senders** with status **Active** and in the **From** list of Slack steps in [Automations](https://support.pynhq.com/flows/automations/). If Pyn rejects the token, the dialog shows "We could not add the custom bot. Please check the token and try again." or Slack's own reason; check you copied the bot token, not the signing secret or an `xoxp-` user token.

## Related

- [Slack](https://support.pynhq.com/integrations/slack/) for the integration itself.
- [Senders](https://support.pynhq.com/settings/senders/) to test or archive the bot.
- [Automations](https://support.pynhq.com/flows/automations/) to send from it.

## Related Intercom articles

- [Set up a Custom Slack Sender/Slack Bot (Pyn 2)](https://intercom.help/pyn/en/articles/16755898-set-up-a-custom-slack-sender-slack-bot-pyn-2) — replaces
- [Send Slack messages from a service account (Pyn 1)](https://intercom.help/pyn/en/articles/9585758-send-slack-messages-from-a-service-account-pyn-1) — Pyn 1 article, kept for reference