> ## 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).
</Note>

## Parameters

<div className="integrations-table">
  | 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.<br />Can be obtained via the `List Repository Workflows` action.                                                |
</div>

## 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)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-workflow-dispatch-with-github-and-send-results-via-email/canvas" />
</div>