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

# Trigger Github Actions using a Configu Webhook

> Learn how to trigger a [GitHub workflow](https://docs.github.com/en/actions/using-workflows/triggering-a-workflow) from a webhook invocation.

## Prerequisites

* Access permissions to create a WebHook for Github Actions.
* Configu Cloud organization with admin permissions (if you donn't have an account, get one free [here](https://app.configu.com))

## Create a Configu Webhook

1. Define your target workflow payload URL: `https://api.github.com/repos/{owner}/{repo}/actions/workflows/{action-id}/dispatches`, example:
   <Frame>
     <img src="https://mintcdn.com/configu/4A2bpem8hiz6pjlo/images-old/webhooks/github-customize-your-payload.png?fit=max&auto=format&n=4A2bpem8hiz6pjlo&q=85&s=257b1fbed2ead9264d9e3b1d51c477e5" alt="image" width="855" height="667" data-path="images-old/webhooks/github-customize-your-payload.png" />
   </Frame>
2. Customize your header to include an `Authorization` header with your GitHub personal access token. Example:
   <Frame>
     <img src="https://mintcdn.com/configu/4A2bpem8hiz6pjlo/images-old/webhooks/github-authorization-header.png?fit=max&auto=format&n=4A2bpem8hiz6pjlo&q=85&s=912424ee98a46c21201fac1f60ac8db1" alt="image" width="1233" height="304" data-path="images-old/webhooks/github-authorization-header.png" />
   </Frame>
3. Customize your payload to contain the data you need, for this example:
   <Frame>
     <img src="https://mintcdn.com/configu/4A2bpem8hiz6pjlo/images-old/webhooks/github-customize-your-payload.png?fit=max&auto=format&n=4A2bpem8hiz6pjlo&q=85&s=257b1fbed2ead9264d9e3b1d51c477e5" alt="image" width="855" height="667" data-path="images-old/webhooks/github-customize-your-payload.png" />
   </Frame>
   you will need to send the following payload data:
   <Frame>
     <img src="https://mintcdn.com/configu/4A2bpem8hiz6pjlo/images-old/webhooks/github-customize-your-payload-2.png?fit=max&auto=format&n=4A2bpem8hiz6pjlo&q=85&s=ef86748a50da26eabe3077f72a392550" alt="image" width="546" height="265" data-path="images-old/webhooks/github-customize-your-payload-2.png" />
   </Frame>

* `ref` is the branch that contains the workflow definition
* `inputs` is the data that the workflow will use that is sent from the webhook
