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

# Trigger a workflow via webhook

> A public endpoint to trigger a workflow that has a `webhook_trigger`. Authentication is handled by the unique, secret token in the URL path. The entire request body will be available in the workflow's context.



## OpenAPI

````yaml /api/en/workflows.yaml post /workflows/webhooks/{webhookToken}
openapi: 3.0.3
info:
  title: Altostrat Workflows API
  version: 1.0.0
  description: >-
    Create, validate, execute, and monitor SDX workflows through the public
    `/workflows` gateway path. The reference intentionally omits internal
    dashboard-builder and local development endpoints.
servers:
  - url: https://v1.api.altostrat.io
    description: Altostrat SDX Production API
security: []
tags:
  - name: Workflows
    description: Manage workflow definitions, the core automation blueprints.
  - name: Workflow Runs
    description: Execute, monitor, and manage individual workflow executions.
  - name: Vault
    description: Securely store and manage secrets used by your workflows.
  - name: Webhooks
    description: Endpoints for triggering workflows from external systems.
  - name: Utilities
    description: Helper endpoints for building and debugging workflows.
  - name: Workflow Logs
    description: Inspect workflow execution logs and aggregate log statistics.
  - name: Authorizations
    description: Manage delegated account authorization for workflow runs.
paths:
  /workflows/webhooks/{webhookToken}:
    post:
      tags:
        - Webhooks
      summary: Trigger a workflow via webhook
      description: >-
        A public endpoint to trigger a workflow that has a `webhook_trigger`.
        Authentication is handled by the unique, secret token in the URL path.
        The entire request body will be available in the workflow's context.
      parameters:
        - name: webhookToken
          in: path
          required: true
          description: The unique, secret token for the webhook-enabled workflow.
          schema:
            type: string
      requestBody:
        description: >-
          The JSON payload for the webhook. This will be available to the
          workflow under `webhook_payload`.
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
            example:
              event_type: user.created
              data:
                id: user_abc123
                email: new.user@example.com
      responses:
        '202':
          description: >-
            Accepted. The webhook has been received and the workflow execution
            has been queued.
        '404':
          description: Not Found. The webhook token is invalid or the workflow is inactive.
        '500':
          description: Internal Server Error. The workflow execution failed to start.

````