> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-studio-tools-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Events

> Receives incoming Slack events (messages, mentions, thread starts).

**URL Verification:** On first setup, Slack sends a `url_verification` challenge. The endpoint echoes back the challenge string.

**Event Processing:** Normal events are acknowledged immediately with `{"status": "ok"}` and processed in the background. This prevents Slack's 3-second retry timeout.

**Retry Handling:** Events with `X-Slack-Retry-Num` header are duplicates and return 200 without reprocessing.

**Setup:** Configure this URL in your [Slack App](https://api.slack.com/apps) under **Event Subscriptions > Request URL**.

See the [setup guide](/agent-os/interfaces/slack/setup) for creating a Slack App or use the [manifest](/agent-os/interfaces/slack/setup#2-create-the-slack-app) for quick setup.




## OpenAPI

````yaml post /slack/events
openapi: 3.1.0
info:
  title: Agno API Reference
  description: The all-in-one, private, secure agent platform that runs in your cloud.
  version: 2.5.6
servers: []
security: []
paths:
  /slack/events:
    post:
      tags:
        - Slack
      summary: Slack Events
      description: Process incoming Slack events
      operationId: slack_events_simple_team
      responses:
        '200':
          description: Event processed successfully
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/SlackChallengeResponse'
                  - $ref: '#/components/schemas/SlackEventResponse'
                title: Response Slack Events Simple Team
        '400':
          description: Missing Slack headers
        '403':
          description: Invalid Slack signature
components:
  schemas:
    SlackChallengeResponse:
      properties:
        challenge:
          type: string
          title: Challenge
          description: Challenge string to echo back to Slack
      type: object
      required:
        - challenge
      title: SlackChallengeResponse
    SlackEventResponse:
      properties:
        status:
          type: string
          title: Status
          default: ok
      type: object
      title: SlackEventResponse

````