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

# Build, Publish, and Trigger Workflows

> Create workflows, publish safely, regenerate trigger tokens, and monitor execution history.

## Audience

* Power users automating operational tasks
* Admins responsible for secure trigger-based automation

## Prerequisites

* Workspace access with workflow permissions
* Plan level that includes workflow functionality
* Clear ownership for trigger token distribution

## Plan and security caveats

* Workflows are plan-gated. If the feature is unavailable, verify subscription and workspace context first.
* Trigger tokens grant execution capability; treat token URLs as secrets.
* Regenerating a token invalidates old trigger links and integrations.

## Steps

### 1) Create workflow

1. Open **Workflows**.
2. Select **Create Workflow** and define flow logic.
3. Save draft and run initial validation.

### 2) Publish workflow

1. Review draft logic and connected actions.
2. Select **Publish** to enable runtime execution.
3. Confirm published state in workflow list/details.

### 3) Trigger workflow externally

1. Copy trigger URL/token from workflow settings.
2. Call trigger endpoint from external system.
3. Confirm execution appears in history.

### 4) Regenerate trigger token (when required)

1. Open workflow trigger settings.
2. Regenerate token after suspected leak or rotation policy.
3. Update all upstream systems with the new token URL.

### 5) Unpublish workflow

1. Open workflow settings.
2. Select **Unpublish** to stop new executions.
3. Verify that new trigger attempts no longer execute.

## Expected result

You can operate the full workflow lifecycle (create -> publish -> trigger -> monitor -> unpublish) with controlled token security and execution visibility.

## Troubleshooting

### Workflow does not trigger

* Confirm workflow is published.
* Verify token URL is current (not regenerated since integration setup).
* Confirm external caller sends expected payload shape.

### Execution starts but fails

* Review execution history details for failing step.
* Validate dependencies/integrations used by workflow action.
* Re-test with minimal payload.

### Feature unavailable/permission denied

* Confirm plan includes workflows.
* Confirm user role has workflow access in this workspace.

If unresolved, contact [support@voqo.ai](mailto:support@voqo.ai) with workspace ID, workflow ID, execution ID (if any), and timestamp.

## Related docs

* [Workflow Concepts and Safety](workflow-concepts-and-safety)
* [Workflow Troubleshooting](workflow-troubleshooting)
* [Plan and Permission Matrix](../admin/plan-and-permission-matrix)