Service Endpoints: Webhooks, Service Bus & Event Hub

Wiring up the endpoints

Webhook configuration

Setting	Details
URL	HTTPS endpoint that receives POST requests
Auth options	HttpHeader, WebhookKey, or HttpQueryString
Payload	RemoteExecutionContext (JSON) — same context as plug-in

Authentication methods

All require HTTPS; HttpHeader is most flexible

Method	How It Works	Security
HttpHeader	Custom header (e.g., x-api-key: abc123)	Good — encrypted in transit
WebhookKey	x-ms-dynamics-key header	Good — Dataverse standard pattern
HttpQueryString	Key appended to URL	Acceptable — encrypted by HTTPS

Azure Service Bus

Queue vs topic

Feature	Queue	Topic + Subscriptions
Consumers	One (competing consumers possible)	Multiple with filters
Use case	Single system processing	Multiple systems reacting

PRT registration steps

1. Create Service Bus namespace in Azure
2. Create queue or topic
3. Create SAS policy with Send permission only
4. Copy connection string → Register in PRT as Service Endpoint

Azure Event Hub

Use Event Hub when you need massive throughput (millions of events) with multiple consumers reading the same stream.

Choose Service Bus	Choose Event Hub
Hundreds to thousands/minute	Millions/minute
Guaranteed ordering within session	Per partition only
Each message processed once	Multiple consumers read same stream
Transaction processing	Analytics, telemetry

Question

What SAS permission should Dataverse have for Service Bus?

Click or press Enter to reveal answer

Answer

Send only. Dataverse publishes messages; consuming applications need separate Listen policies. This follows least privilege.

Click to flip back

Question

When should you use a Service Bus topic instead of a queue?

Click or press Enter to reveal answer

Answer

When multiple systems need to react to the same event. Each system has its own subscription (with optional filters). A queue delivers each message to only one consumer.

Click to flip back

Knowledge Check

A company needs to send Dataverse order events to three systems: warehouse, analytics, and CRM sync. Each must receive every event. What endpoint?

AThree separate webhooksBOne Service Bus queueCOne Service Bus topic with three subscriptionsDOne Event Hub

Check Answer

Next up: Data Sync — change tracking, alternate keys, and the UpsertRequest pattern.