# Receive Slack interactions

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

## 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/interactions

**Receive Slack interactions**

Validates the Slack request signature and forwards interaction payloads to the jobs service. `view_submission` interactions return a JSON clear response; other interaction types return HTTP 200 with an empty body.

**Header parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `x-slack-signature` | string | Yes |  |
| `x-slack-request-timestamp` | string | Yes |  |

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

- `payload` (string, required): JSON-stringified Slack interaction payload.

**Responses:**

- `200` - Interaction accepted
  - `response_action` (enum: clear, required)

  Example (view_submission):
  
  ```json
  {
  "response_action": "clear"
}
  ```
- `400` - Missing or invalid interaction payload
  - `error` (string, required)
- `401` - Missing or invalid Slack signature headers
  - `error` (string, required)
- `405` - Method not allowed
  - `error` (string, required)
- `502` - Failed to queue interaction callback
  - `error` (string, required)

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/integrations/slack/interactions" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "x-slack-request-timestamp: 1739612400" \
  -H "x-slack-signature: v0=..." \
  --data-urlencode 'payload={"type":"block_actions","team":{"id":"T123"}}'
```