/v1/incoming-webhook/{workspaceId}/{testID}

Webhook
POST <baseUrl>/v1/incoming-webhook/{workspaceId}/{testID}

POST Receive incoming webhook for a specific test

Receives a webhook for a given workspace and test. This endpoint expects a POST request and requires authentication via API key or bearer token.

Parameters

Name In Required Type Description
workspaceId path Required [string] The workspace identifier.
testID path Required [string] The test identifier.

Request Body

Optional
application/json
Schema: WebhookPayload
dataExample - Data submission payload 
{
  "data": {
    "details": {
      "amount": 100.5,
      "currency": "USD"
    },
    "id": "transaction-123",
    "status": "completed"
  },
  "event": "data_submission",
  "timestamp": "2025-05-14T20:05:00Z"
}
triggerExample - Trigger event payload 
{
  "data": {
    "foo": "bar",
    "status": "success"
  },
  "event": "trigger",
  "timestamp": "2025-05-14T20:00:00Z"
}

Responses

200 Webhook received successfully.
application/json
Schema: WebhookResponse
success - Success response 
{
  "message": "Webhook received",
  "receivedAt": "2025-05-14T20:00:05Z",
  "status": "success"
}
400 Bad request - invalid payload format
application/json
Schema: ErrorResponse
401 Unauthorized
404 Test ID not found
500 Internal server error

Security

  • apiKeyAuth [apiKey]
    API Key authentication. Use the X-API-KEY header (generated from the Vaktum portal) to authenticate directly to a workspace.
    In: header
    Name: X-API-KEY
  • bearerAuth [http]
    OAuth2 authentication. Use the Authorization header with a Bearer token. Also provide X-WORKSPACE-ID header for workspace context.
    Scheme: bearer
    Bearer Format: JWT