---
title: "Receive Slack commands"
method: POST
path: "/v1/integrations/slack/{connectionId}/commands"
tags: ["Webhooks"]
---

# Receive Slack commands

`POST /v1/integrations/slack/{connectionId}/commands`

Verify the signed Slack slash command and return an ephemeral link for the member to connect their own account in OpenWork.

## Path parameters

- `connectionId` string, typeid, required

## Response `200`

Private connection instructions.

- object
  - `response_type` 'ephemeral', required
  - `text` string, required

## Other responses

- `400` — Invalid parameters or Slack payload.
- `401` — Missing installation or invalid Slack signature.
- `403` — Slack workspace or app does not match this installation.
- `413` — Slack payload exceeds the request size limit.

## Changes

- **2026-10-01** `df3754993784` — 1 info
  - added the optional property `anyOf[#/components/schemas/InvalidRequestError]/message` to the response with the `400` status
- **2026-10-01** `406852f37cc0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/integrations/slack/:connectionId/commands/post.md)

---

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