---
title: "Start connecting a Slack workspace to the organization. Leaves the organization with a pending connection (reusing the one it already has) and returns the Slack URL the user has to open. The authorization expires after 15 minutes and only the same user can complete it."
method: POST
path: "/v2/organizations/{organizationId}/slack-connections/authorizations"
tags: ["Organization Slack Connections Api Service"]
---

# Start connecting a Slack workspace to the organization. Leaves the organization with a pending connection (reusing the one it already has) and returns the Slack URL the user has to open. The authorization expires after 15 minutes and only the same user can complete it.

`POST /v2/organizations/{organizationId}/slack-connections/authorizations`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/organizations/{organizationId}/slack-connections/authorizations`
- Auth: none declared

## Path parameters

- `organizationId` integer, required

## Response `200`

Authorization started.

- JsonOkResponseSlackAuthorizationDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` SlackAuthorizationDto: A started "Connect with Slack" authorization.
    - `authorizeUrl` string: Slack page the user has to open to approve the app. When they approve it, Slack sends them back to /public/integrations/slack/oauth-callback with code and state, which the front sends to POST /v2/organizations/{organizationId}/slack-connections within 15 minutes.

## Other responses

- `403`: Caller is not a regular-user session, or is neither the organization owner nor a team member with manageBrands (a team member also needs the organization to be usable: its permissions feature and the owner's plan). Also slackPlanRequired: the owner's plan does not allow Slack (slack-availability locked or planLocked).
- `404`: Organization not found, or its owner account could no longer be resolved.
- `503`: slackNotConfigured: this environment has no Slack app credentials.

---

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