---
title: "POST /v1/orgs/{orgId}/integrations/slack/callback"
method: POST
path: "/v1/orgs/{orgId}/integrations/slack/callback"
tags: ["Orgs", "Integrations"]
---

# POST /v1/orgs/{orgId}/integrations/slack/callback

`POST /v1/orgs/{orgId}/integrations/slack/callback`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/v1/orgs/{orgId}/integrations/slack/callback`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tessl/apis/tessl-api/docs/v1/orgs/:orgId/integrations/slack/callback/post.ts> (a function with typed inputs; its response is checked against the schema)

Completes connecting a Slack workspace to the organization with the `code` and `state` Slack sent to the redirect URI, and returns the connection. Returns 400 when the state was not issued to the caller for this organization or has expired, or when Slack refuses the code. Connecting a Slack workspace the organization already holds for the same app replaces the earlier connection. Returns 503 when this instance cannot connect Slack workspaces.

## Path parameters

- `orgId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `code` string, required
  - `state` string, required

## Response `201`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'integration', required
    - `attributes` object, required
      - `type` 'slack-app', required
      - `installedBy` string, uuid, required
      - `connectionData` object, required
        - `slackTeamId` string, required
        - `slackAppId` string, required
        - `botUserId` string, required
      - `metadata` object, required
        - `slackTeamName` string
      - `createdAt` string, required
      - `updatedAt` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-11** `40be904c23c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/v1/orgs/:orgId/integrations/slack/callback/post.md)

---

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