---
title: "Save a MagicBell SlackBot installation"
method: PUT
path: "/integrations/magicbell_slackbot/installations"
tags: ["magicbell_slackbot"]
---

# Save a MagicBell SlackBot installation

`PUT /integrations/magicbell_slackbot/installations`

Creates a new installation of a MagicBell SlackBot integration for a user. This endpoint is used when an integration needs to be set up with user-specific credentials or configuration.

## Request body

- SlackInstallation
  - `access_token` string, required — Bot token returned from the Slack OAuth exchange.
  - `app_id` string, required — Slack app identifier for the installed app.
  - `authed_user` object, required
    - `access_token` string — User token returned from the OAuth exchange.
    - `expires_in` integer — Seconds until the user token expires.
    - `id` string, required — Slack user ID for the installer.
    - `refresh_token` string — Refresh token for the authed user.
    - `scope` string — Space-delimited OAuth scopes granted to the user token.
    - `token_type` string — Token type value provided by Slack.
  - `bot_user_id` string — Slack user ID of the installed bot.
  - `enterprise` object
    - `id` string, required — Enterprise grid identifier.
    - `name` string, required — Enterprise grid name.
  - `expires_in` integer — Seconds until the bot access token expires.
  - `id` string — Unique identifier MagicBell assigns to the Slack installation.
  - `incoming_webhook` object
    - `channel` string, required — Human readable name for the webhook channel.
    - `configuration_url` string, required — URL users can visit to manage the webhook.
    - `url` string, required — Webhook URL that Slack posts events to.
  - `is_enterprise_install` boolean — Indicates whether the installation occurred on an enterprise grid.
  - `refresh_token` string — Refresh token for regenerating the bot access token.
  - `scope` string — Space-delimited OAuth scopes granted to the bot token.
  - `team` object, required
    - `id` string, required — Workspace ID where the app was installed.
    - `name` string — Workspace name where the app was installed.
  - `token_type` string — Type of bot token returned by Slack.

## Response `200`

OK

- SlackInstallation
  - `access_token` string, required — Bot token returned from the Slack OAuth exchange.
  - `app_id` string, required — Slack app identifier for the installed app.
  - `authed_user` object, required
    - `access_token` string — User token returned from the OAuth exchange.
    - `expires_in` integer — Seconds until the user token expires.
    - `id` string, required — Slack user ID for the installer.
    - `refresh_token` string — Refresh token for the authed user.
    - `scope` string — Space-delimited OAuth scopes granted to the user token.
    - `token_type` string — Token type value provided by Slack.
  - `bot_user_id` string — Slack user ID of the installed bot.
  - `enterprise` object
    - `id` string, required — Enterprise grid identifier.
    - `name` string, required — Enterprise grid name.
  - `expires_in` integer — Seconds until the bot access token expires.
  - `id` string — Unique identifier MagicBell assigns to the Slack installation.
  - `incoming_webhook` object
    - `channel` string, required — Human readable name for the webhook channel.
    - `configuration_url` string, required — URL users can visit to manage the webhook.
    - `url` string, required — Webhook URL that Slack posts events to.
  - `is_enterprise_install` boolean — Indicates whether the installation occurred on an enterprise grid.
  - `refresh_token` string — Refresh token for regenerating the bot access token.
  - `scope` string — Space-delimited OAuth scopes granted to the bot token.
  - `team` object, required
    - `id` string, required — Workspace ID where the app was installed.
    - `name` string — Workspace name where the app was installed.
  - `token_type` string — Type of bot token returned by 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)