POST/api/v1/inbound-webhooks/{id}/test

Product availabilityAlgaPSA

Send inbound webhook test request

Dispatches a synthetic inbound request through the current webhook configuration.

RBAC · inbound_webhook

Path parameters

idstring <uuid>Required

Inbound webhook UUID.

Request body

Content type: application/json

bodyany

headersobject

Response body

Success response 200

dataobjectRequired

tenantstring <uuid>Required

deliveryIdstring <uuid>Required

inboundWebhookIdstring <uuid>RequiredNullable

idempotencyKeystringRequiredNullable

receivedAtstring <date-time>Required

requestMethodstringRequired

requestPathstringRequired

requestHeadersobjectRequired

requestBodyany

sourceIpstringRequiredNullable

userAgentstringRequiredNullable

authStatusstringRequired

Enum: verifiedrejected_signaturerejected_bearerrejected_iprejected_no_auth

dispatchStatusstringRequired

Enum: pendingdispatchedduplicatefailed

handlerOutcomeobjectRequiredNullable

responseStatusintegerRequiredNullable

responseBodyany

durationMsintegerRequiredNullable

retryCountintegerRequired

isReplaybooleanRequired

replayedFromstring <uuid>RequiredNullable

createdAtstring <date-time>Required

updatedAtstring <date-time>Required

Response codes

200

Synthetic inbound delivery accepted.

400

Invalid inbound webhook request.

401

Missing or invalid authenticated user context.

403

Inbound webhook permission denied.

404

Inbound webhook not found.

500

Unexpected inbound webhook operation failure.

POST /api/v1/inbound-webhooks/{id}/test

cURL

curl -X POST "https://algapsa.com/api/v1/inbound-webhooks/{id}/test" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "body": null,
  "headers": {}
}'

TypeScript

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

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

200 OK·application/json

{
  "data": {
    "tenant": "01HN2K7VRB9PQ3Y0000000000",
    "deliveryId": "01HN2K7VRB9PQ3Y0000000000",
    "inboundWebhookId": "01HN2K7VRB9PQ3Y0000000000",
    "idempotencyKey": "string",
    "receivedAt": "2026-04-18T15:22:14Z",
    "requestMethod": "string",
    "requestPath": "string",
    "requestHeaders": {},
    "requestBody": null,
    "sourceIp": "string",
    "userAgent": "string",
    "authStatus": "verified",
    "dispatchStatus": "pending",
    "handlerOutcome": {},
    "responseStatus": 1,
    "responseBody": null,
    "durationMs": 1,
    "retryCount": 1,
    "isReplay": false,
    "replayedFrom": "01HN2K7VRB9PQ3Y0000000000",
    "createdAt": "2026-04-18T15:22:14Z",
    "updatedAt": "2026-04-18T15:22:14Z"
  }
}