Receive Slack events

Validates Slack request signatures. URL verification challenges are returned immediately; event callbacks are queued for downstream processing.

Header Parameters

x-slack-signature*string

x-slack-request-timestamp*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

type?string

Value in

"url_verification"
"event_callback"

challenge?string

event_id?string

team_id?string

event?

Response Body

`application/json`

curl -X POST "https://app.orbiqhq.com/api/v1/integrations/slack/events" \  -H "Content-Type: application/json" \  -H "x-slack-request-timestamp: 1739612400" \  -H "x-slack-signature: v0=..." \  -d '{  "type": "event_callback",  "event_id": "Ev123",  "team_id": "T123",  "event": {    "type": "file_shared",    "channel": "C123",    "user": "U123"  }}'

{  "challenge": "challenge-token"}

How is this guide?

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

405application/json

502application/json

Example verification

Example accepted

Example ignored

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`