When to use AzureFunction or Webhook as the endpoint type

Question

The guidance here in this page

(https://learn.microsoft.com/en-us/azure/event-grid/handler-webhooks) compared to this page (https://learn.microsoft.com/en-us/azure/event-grid/handler-functions) has conflicting or confusing information.

On the first page, (https://learn.microsoft.com/en-us/azure/event-grid/handler-webhooks) it says to use AzureFunction as the endpoint type: "Even though you can use Webhook as an endpoint type to configure an Azure function as an event handler, use Azure Function as an endpoint type. For more information, see Azure function as an event handler.".

Then, on the linked page (https://learn.microsoft.com/en-us/azure/event-grid/handler-functions) it says to use Webhook as the endpoint type.

Which is it?

Answer 1

@Mark Lottes The exception to using WebHook even for Azure Function is only when your function is protected using Azure AD.

This is because Event Grid only supports key-based authentication when using Azure Functions.

Answer 2

Hi Mark,

You want to use Event Grid Trigger with Azure Function as the endpoint type. The reason is, it will handle the validation response for you. If you do webhook instead, you need to write code to handle the validation response yourself.

For understand purposes, please see below document where it describes the things you would need to code to properly handle the validation response (if you chose webhook):

Endpoint validation with Event Grid events

https://learn.microsoft.com/en-us/azure/event-grid/webhook-event-delivery#endpoint-validation-with-event-grid-events

Please click Accept Answer if the above was useful. If something is unclear please add a comment.

Thanks.

-TP