---
title: "Slack's authorize page, with a signed state that works once, for 10 minutes."
method: GET
path: "/v1/apps/slack/install"
tags: ["apps"]
---

# Slack's authorize page, with a signed state that works once, for 10 minutes.

`GET /v1/apps/slack/install`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/apps/slack/install`
- Auth: HTTP bearer

Portal session only; in a team, the owner or an admin. Slack sends the person back to the portal's Integrations page with `installed=slack`, or `error=` denied, expired, already_installed or failed. 503 `slack_not_configured` when Slack is not set up.

## Response `200`

OK

- AppsSlackInstallResponse
  - `url` string, required

## Other responses

- `401`: No key or token, or it expired or was revoked.
- `403`: The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)