# Receive Slack slash commands

URL: /en/docs/api/v1/integrations/slack/commands/post
Last Updated: 2026-07-30T21:15:30.597Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/integrations/slack/commands

**Receive Slack slash commands**

Validates the Slack request signature, resolves command intent, and forwards the callback payload to the jobs service.

**Header parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `x-slack-signature` | string | Yes | Slack HMAC signature header. |
| `x-slack-request-timestamp` | string | Yes | Unix timestamp used for replay protection. |

**Request body** (`application/x-www-form-urlencoded`) - required:

- `command` (string)
- `text` (string)
- `team_id` (string)
- `channel_id` (string)
- `user_id` (string)
- `trigger_id` (string)

**Responses:**

- `200` - Slash command accepted
  - `response_type` (enum: ephemeral, required)
  - `text` (string, required)

  Example (subscribed):
  
  ```json
  {
  "response_type": "ephemeral",
  "text": "Access request notifications enabled for this channel."
}
  ```
- `401` - Missing or invalid Slack signature headers
  - `error` (string, required)
- `405` - Method not allowed
  - `error` (string, required)
- `502` - Failed to queue command callback
  - `error` (string, required)

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/integrations/slack/commands" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "x-slack-request-timestamp: 1739612400" \
  -H "x-slack-signature: v0=..." \
  --data-urlencode "command=/orbiq" \
  --data-urlencode "text=subscribe" \
  --data-urlencode "team_id=T123" \
  --data-urlencode "channel_id=C123" \
  --data-urlencode "user_id=U123"
```