---
title: "Save a MagicBell SlackBot token"
method: PUT
path: "/channels/slack/magicbell_slackbot/tokens"
tags: ["slack", "magicbell_slackbot"]
---

# Save a MagicBell SlackBot token

`PUT /channels/slack/magicbell_slackbot/tokens`

Saves the MagicBell SlackBot token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.

## Request body

- SlackTokenPayload
  - `oauth` object
    - `channel_id` string, required — The ID of the Slack channel this installation is associated with
    - `installation_id` string, required — A unique identifier for this Slack workspace installation
    - `scope` string — The OAuth scope granted during installation
  - `webhook` object — Obtained directly from the incoming_webhook object in the installation response from the Slack API.
    - `url` string, uri, required — The URL for the incoming webhook from Slack

## Response `200`

OK

- SlackTokenPayload
  - `oauth` object
    - `channel_id` string, required — The ID of the Slack channel this installation is associated with
    - `installation_id` string, required — A unique identifier for this Slack workspace installation
    - `scope` string — The OAuth scope granted during installation
  - `webhook` object — Obtained directly from the incoming_webhook object in the installation response from the Slack API.
    - `url` string, uri, required — The URL for the incoming webhook from Slack

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)