---
title: "Initiate a Slack workspace OAuth install"
method: POST
path: "/v1/projects/{projectId}/slack/connections/initiate"
tags: ["Slack Connections", "tier:standard"]
---

# Initiate a Slack workspace OAuth install

`POST /v1/projects/{projectId}/slack/connections/initiate`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/projects/{projectId}/slack/connections/initiate`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns the Slack /oauth/v2/authorize URL the user's browser should be redirected to. The surface (Particle Slack app vs Radar Slack app) is inferred from the calling request — Radar-issuer JWTs install the Radar app; everything else installs the Particle app. JWT auth required; API keys cannot install OAuth on behalf of a user.

## Path parameters

- `projectId` string, required: Project ID (base62-encoded).

## Request body

- InitiateSlackConnectionBody
  - `redirect_url` string, required: URL on the calling surface (platform.particle.pro / radar.particle.pro) to redirect the user's browser to after the OAuth dance completes. Must match the calling surface's host.

## Response `200`

OK

- InitiateSlackConnectionResponseBody
  - `authorize_url` string, required

## Other responses

- `default`: Error

---

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