Getting Started with Incoming Webhooks

This guide will walk through everything needed in order to build a FlexDeploy Project with a GitHub webhook.

1 Getting a GitHub message into FlexDeploy
- 1.1 Creating the GitHub Provider
- 1.2 Creating a BuildProject Function
- 1.3 Creating a public endpoint (Optional)
  - 1.3.1 ngrok
- 1.4 Security Warning
- 1.5 Adding a Webhook to GitHub
- 1.6 Trying it out
2 Building the Project
- 2.1 Updating our BuildProject Function
- 2.2 Creating our FlexDeploy Project
- 2.3 Testing it out
- 2.4 Resubmitting
3 Finishing the GitHub Provider
- 3.1 Updating the Match Script
  - 3.1.1 GitHub Provider
- 3.2 Setting the GitHub Secret
- 3.3 Properties
- 3.4 Final Validation

Getting a GitHub message into FlexDeploy

The very first step before we can consider building a project is to simply get a Github message into FlexDeploy so we know what we are dealing with. For this to occur there are 4 things we need

A FlexDeploy Webhook Provider for GitHub
A FlexDeploy Webhook Function - this is what will ultimately build our Project
A public endpoint for GitHub to send the message to.
A GitHub Repository with Webhooks enabled.

Creating the GitHub Provider

Navigate to Administration → Incoming Webhooks

Click the Configuration button in the top right of the page, and then the button at the top right of the table to create a new Provider.