Publish test inbound email event

Publishes a synthetic INBOUND_EMAIL_RECEIVED event to the workflow event stream so operators can test webhook and workflow delivery without a real provider notification. Requires a valid Auth.js session; tenant is taken from the authenticated user session. The route performs no RBAC check and does not require an API key.

Request body

Content type: application/json · schema EmailWebhookTestRequest

providerstring

Email provider type to simulate in the synthetic inbound email event. Defaults to microsoft.

Enum: microsoftgoogle

messageIdstring

Synthetic message identifier to include in the test event. Defaults to test-message-123.

Response body

Success response 200 · schema EmailWebhookTestResponse

successbooleanRequired

Test event was published successfully.

Enum: true

messagestringRequired

Human-readable success message.

eventIdstringRequired

Redis Streams event ID returned by publishEvent.

tenantstringRequired

Tenant identifier from the authenticated user session.

Response codes

200

Test event was published successfully.

401

No authenticated user session was found.

500

Failed to publish the test event.

POST /api/email/webhooks/test

cURL

curl -X POST "https://algapsa.com/api/email/webhooks/test" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "provider": "microsoft",
  "messageId": "string"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/email/webhooks/test", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "provider": "microsoft",
    "messageId": "string"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/email/webhooks/test");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""provider"": ""microsoft"",
  ""messageId"": ""string""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "success": true,
  "message": "string",
  "eventId": "string",
  "tenant": "string"
}