Learn how to create a function that is triggered by an HTTP webhook request with a GitHub-specific payload.
Before running this sample, you must have the following:
- A GitHub account with at least one project.
If you don't have an Azure subscription, create a free account before you begin.
Add Function Apps to your portal favorites
If you haven't already done so, add Function Apps to your favorites in the Azure portal. This makes it easier to find your function apps. If you have already done this, skip to the next section.
Log in to the Azure portal.
Click the arrow at the bottom left to expand all services, type
Functionsin the Filter field, and then click the star next to Function Apps.
This adds the Functions icon to the menu on the left of the portal.
Close the menu, then scroll down to the bottom to see the Functions icon. Click this icon to see a list of all your function apps. Click your function app to work with functions in this app.
Create an Azure Function app
Click the New button found on the upper left-hand corner of the Azure portal.
Click Compute > Function App, select your Subscription. Then, use the function app settings as specified in the table.
Setting Suggested value Description App name Globally unique name Name that identifies your new function app. Resource Group myResourceGroup Name for the new resource group in which to create your function app. Hosting plan Consumption plan Hosting plan that defines how resources are allocated to your function app. In the default Consumption Plan, resources are added dynamically as required by your functions. You only pay for the time your functions run. Location West Europe Choose a location near you or near other services your functions will access. Storage account Globally unique name Name of the new storage account used by your function app. You can also use an existing account.
Click Create to provision and deploy the new function app.
Next, you create a function in the new function app.
Create a GitHub webhook triggered function
Expand your function app, click the + button next to Functions, click the GitHubWebHook template for your desired language. Name your function, then click Create.
In your new function, click </> Get function URL, then copy and save the values. Do the same thing for </> Get GitHub secret. You use these values to configure the webhook in GitHub.
Next, you create a webhook in your GitHub repository.
Configure the webhook
In GitHub, navigate to a repository that you own. You can also use any repository that you have forked. If you need to fork a repository, use https://github.com/Azure-Samples/functions-quickstart.
Click Settings, then click Webhooks, and Add webhook.
Use settings as specified in the table, then click Add webhook.
|Payload URL||Copied value||Use the value returned by </> Get function URL.|
|Secret||Copied value||Use the value returned by </> Get GitHub secret.|
|Content type||application/json||The function expects a JSON payload.|
|Event triggers||Let me select individual events||We only want to trigger on issue comment events.|
Now, the webhook is configured to trigger your function when a new issue comment is added.
Test the function
In your GitHub repository, open the Issues tab in a new browser window.
In the new window, click New Issue, type a title, and then click Submit new issue.
In the issue, type a comment and click Comment.
Go back to the portal and view the logs. You should see a trace entry with the new comment text.
Clean up resources
Other quick starts in this collection build upon this quick start. If you plan to continue on to work with subsequent quick starts or with the tutorials, do not clean up the resources created in this quick start.
If you do not plan to continue, click the Resource group for the function app in the portal, and then click Delete.
You have created a function that runs when a request is received from a GitHub webhook.
Learn how to create functions with other kinds of triggers or how to integrate functions with other Azure services.
- Create a function that runs on a schedule
- Create a function triggered by Storage queue messages
- Create a function triggered by a GitHub webhook
- Add messages to an Azure Storage queue using Functions
For more information about webhook triggers, see Azure Functions HTTP and webhook bindings.