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

# Trigger automation

> Manually trigger an automation by its ID.

Triggers the specified automation immediately, regardless of its configured trigger type. The execution runs asynchronously and returns an execution ID you can use to track the run.

<Warning>
  The automation must be **enabled** (`isEnabled: true`) to trigger it. Triggering a disabled automation returns a `400` error. You must have at least Member permissions in the space that owns the automation.
</Warning>

<Note>
  This endpoint is suited for automations with `triggerType` of `MANUAL` or `WEBHOOK`. Automations with scheduled or event-based trigger types can also be triggered this way for testing purposes.
</Note>

## Path parameters

<ParamField path="automationId" type="string" required>
  The ID of the automation to trigger.
</ParamField>

## Request body

<ParamField body="payload" type="object">
  Optional data to pass into the first node of the automation flow. Send an empty object `{}` if no input data is needed.
</ParamField>

## Response

<ResponseField name="executionId" type="string" required>
  Unique identifier for this execution. Use this to look up the execution status or logs.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl -X POST "https://your-collabase.ch/api/v1/automation/auto-abc123/trigger" \
    -H "Authorization: Bearer cba_live_xYz123ABCD..." \
    -H "Content-Type: application/json" \
    -d '{
      "payload": {}
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={"dark"}
  {
    "executionId": "exec-xyz789"
  }
  ```

  ```json 400 theme={"dark"}
  {
    "error": "Automation is disabled"
  }
  ```

  ```json 401 theme={"dark"}
  {
    "error": "Unauthorized"
  }
  ```

  ```json 403 theme={"dark"}
  {
    "error": "Forbidden"
  }
  ```

  ```json 404 theme={"dark"}
  {
    "error": "Not found"
  }
  ```
</ResponseExample>