---
title: "Begin the Slack Connect flow"
method: POST
path: "/api/me/destinations/slack/oauth/start"
tags: ["me"]
---

# Begin the Slack Connect flow

`POST /api/me/destinations/slack/oauth/start`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/destinations/slack/oauth/start`
- Auth: none declared

Mints a 10-min state JWT scoped to the calling customer and returns Slack's authorize URL with the state embedded. The portal redirects the browser to authorizeUrl. After the customer approves, Slack hits GET /api/destinations/slack/oauth/callback which verifies the state, exchanges the code, and creates the destination.

## Response `200`

Authorize URL ready

- object
  - `authorizeUrl` string, uri, required

## Other responses

- `503`: Slack OAuth not configured on this environment

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)