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

# GitHub

> Add a task to an Audimate workflow for new GitHub issues or other repository events, using a repository webhook pointed at Audimate.

A repository webhook sends GitHub events to Audimate, such as each new issue. You need admin access to
the repository.

## Events you can pick

One trigger adds tasks for one event. For two events, add two triggers.

| Event in Audimate | When it adds a task |
| - | - |
| New issue | Someone opens an issue |
| Issue closed | An issue is closed |
| New comment | Someone comments on an issue or pull request |
| New pull request | Someone opens a pull request |
| Pull request merged | A pull request is merged |
| New release | A release is published |

## Get your URL in Audimate

**1. Open the workflow's Triggers tab**

Open the workflow that should get the tasks, then choose the **Triggers** tab.

**2. Choose Add trigger, then the app**

Search for **GitHub** and select it.

**3. Pick the event**

When GitHub offers more than one event, pick the one that should add a task, then choose
**Continue**. Every other event it sends is skipped.

**4. Copy the URL**

Choose **Copy**. You see the URL once, so leave this window open until you've pasted it. The setup
waits until the event arrives.

## Add the webhook in GitHub

**1. Open the repository's settings**

On GitHub, open the repository, choose **Settings**, then **Webhooks**.

**2. Choose Add webhook**

Paste the Audimate URL into **Payload URL**.

**3. Set the content type**

Set **Content type** to **application/json**. With the other choice, Audimate gets the event as
one block of text it can't split into values.

**4. Add a secret (optional)**

Type a secret into **Secret**, then paste the same secret into **Signing secret** in Audimate and
choose **Save**. The trigger then refuses any request GitHub didn't sign with it.

**5. Pick the events**

Choose **Let me select individual events**, then select the one your trigger is for: **Issues**
for an issue event, **Pull requests** for a pull request event, and so on.

**6. Choose Add webhook**

GitHub saves the webhook and sends a short test called a ping. Audimate skips it, since it isn't
the event you picked.

**7. Send a real event**

Make the event happen once, such as opening an issue, so Audimate gets an event with real values.

## Finish in Audimate

**1. Choose Next**

Back in Audimate, the setup says **Your first event arrived**. Choose **Next**.

**2. Fill in each field**

For each task field, pick the part of the event that fills it. Under each field you see what this
event gives it.

**3. Choose where new tasks go**

Pick **Inbox** to start tasks yourself, or your pick-up list to have them start on their own.

**4. Choose Turn on**

The trigger's switch turns on, and each new event now adds a task.

See [Triggers](/concepts/triggers.md) for what each warning under a field means.

## If nothing arrives

> **GitHub shows a failed delivery**
>
> In the repository's **Webhooks** settings, open the webhook and choose **Recent Deliveries**. Check
> the URL, then choose **Redeliver**.

> **GitHub's delivery says the request wasn't signed or doesn't match**
>
> The secret in GitHub and the trigger's signing secret differ, or only one of them has one. Type
> the same secret into both, or remove it from both.

> **The setup says it was a different event**
>
> GitHub sent something other than the event you picked, often the ping. Make the event itself
> happen once, such as opening an issue.

## Related

> **[Triggers](/concepts/triggers.md)**
>
> How a trigger fills a task and what its activity shows.

> **[Task boards](/data/boards.md)**
>
> Where the tasks a trigger adds wait and start.


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