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

# Create Workflow Dispatch

You can use this endpoint to manually trigger a GitHub Actions workflow run. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`.

You must configure your GitHub Actions workflow to run when the [`workflow_dispatch` webhook](https://docs.github.com/en/webhooks/webhook-events-and-payloads#workflow_dispatch) event occurs. The `inputs` are configured in the workflow file. For more information about how to configure the `workflow_dispatch` event in the workflow file, see "[Events that trigger workflows](https://docs.github.com/actions/reference/events-that-trigger-workflows#workflow_dispatch)."

You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint. For more information, see "[Creating a personal access token for the command line](https://docs.github.com/articles/creating-a-personal-access-token-for-the-command-line).".

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [GitHub documentation](https://docs.github.com/rest/reference/actions#create-a-workflow-dispatch-event).

## Parameters

| Parameter | Description |
| - | - |
| Inputs | Input keys and values configured in the workflow file. The maximum number of properties is 10. Any default properties configured in the workflow file will be used when `inputs` are omitted. |
| Owner | The account owner of the repository. The name is not case sensitive. |
| Ref | The git reference for the workflow. The reference can be a branch or tag name. |
| Repo | The name of the repository. The name is not case sensitive. |
| Workflow ID | The ID of the workflow. You can also pass the workflow file name as a string. Can be obtained via the `List Repository Workflows` action. |

## Workflow Library Example

[Create Workflow Dispatch with Github and Send Results Via Email](https://library.blinkops.com/workflows/create-workflow-dispatch-with-github-and-send-results-via-email)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/create-workflow-dispatch-with-github-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/create-workflow-dispatch-with-github-and-send-results-via-email/canvas)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.