---
title: "Get the Add-to-Slack install URL for a project"
method: GET
path: "/slack/app/install-url"
tags: ["Slack"]
---

# Get the Add-to-Slack install URL for a project

`GET /slack/app/install-url`

## Request

- Base URL: `https://api.apphandoff.com/api`
- URL: `https://api.apphandoff.com/api/slack/app/install-url`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sb-access-token`

Admin-only. Returns a signed, single-use OAuth install URL.

## Query parameters

- `projectId` string, uuid, required

## Response `200`

Install URL

- object
  - `installUrl` string, uri, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Forbidden
- `500`: Server error

---

[API](https://skmtc.dev/apphandoff/apis/apphandoff-api.md) · [All operations](https://skmtc.dev/apphandoff/apis/apphandoff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apphandoff/apis/apphandoff-api/revisions/9f138fe46d56?raw)