Skip to main content
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.

​
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 for what each warning under a field means.

​
If nothing arrives

In the repository’s Webhooks settings, open the webhook and choose Recent Deliveries. Check the URL, then choose Redeliver.
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.
GitHub sent something other than the event you picked, often the ping. Make the event itself happen once, such as opening an issue.

Triggers

How a trigger fills a task and what its activity shows.

Task boards

Where the tasks a trigger adds wait and start.