Validate Microsoft email webhook subscription

Microsoft Graph subscription validation endpoint. During subscription creation or renewal, Microsoft calls this endpoint with validationtoken or validationToken. The handler echoes the token verbatim as text/plain. If no token is provided, it returns OK. No session, API key, tenant header, or request body is required.

Query parameters

validationtokenstringOptional

Microsoft Graph subscription validation token. The handler also accepts validationToken with camel-case spelling.

validationTokenstringOptional

Camel-case variant of the Microsoft Graph validation token.

Response codes

200

Plain text validation token echo, or OK when no validation token is present.

500

Unexpected error while handling validation request.

GET /api/email/webhooks/microsoft

cURL

curl -X GET "https://algapsa.com/api/email/webhooks/microsoft?validationtoken=string&validationToken=string" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/email/webhooks/microsoft?validationtoken=string&validationToken=string", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/email/webhooks/microsoft?validationtoken=string&validationToken=string");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();