> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getdialed.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive a webhook (called by your external system)

> The public receiver endpoint your external system POSTs to. It carries **no API-key/JWT auth** — the trust boundary is the HMAC signature verified on the raw request body, and the tenant is resolved from the URL slug. An unknown slug or webhook returns 404 (never 401, to avoid leaking existence); a signature failure returns 401; over-limit returns 429. On success it acks 202 within ~50ms and dispatches the job off-path. See the [Receive webhooks guide](/guides/receive-webhooks). This endpoint is not callable from the interactive playground.



## OpenAPI

````yaml /openapi.json post /webhooks/{slug}/{webhook_id}
openapi: 3.1.0
info:
  title: GetDialed Flows API
  version: 0.1.0
servers:
  - url: https://api.getdialed.ai/flows
    description: Production
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /webhooks/{slug}/{webhook_id}:
    post:
      tags:
        - webhooks
      summary: Receive a webhook (called by your external system)
      description: >-
        The public receiver endpoint your external system POSTs to. It carries
        **no API-key/JWT auth** — the trust boundary is the HMAC signature
        verified on the raw request body, and the tenant is resolved from the
        URL slug. An unknown slug or webhook returns 404 (never 401, to avoid
        leaking existence); a signature failure returns 401; over-limit returns
        429. On success it acks 202 within ~50ms and dispatches the job
        off-path. See the [Receive webhooks guide](/guides/receive-webhooks).
        This endpoint is not callable from the interactive playground.
      operationId: receive_webhook_webhooks__slug___webhook_id__post
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
            title: Slug
        - name: webhook_id
          in: path
          required: true
          schema:
            type: string
            title: Webhook Id
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````