Fire Sandbox Event

Trigger a synthetic webhook event without running a real submission. Looks up all assets in the submission and dispatches one event per asset to all active subscriptions in the identity's workspace that subscribe to the given event type. No credits are consumed. Useful for end-to-end testing of your webhook handler before going live. Authentication: Requires X-API-Key header with a sandbox (sk_test_) key. Args: request_data: Event type and submission ID to target. For ``asset.processing.failed`` events an optional ``error_message`` is forwarded to subscribers; defaults to "Sandbox simulated failure". Returns: FireSandboxEventResponse with the total count of subscriptions notified across all assets. Raises: 403: If the API key is not a sandbox (sk_test_) key. 404: If the submission is not found in the authenticated workspace. 422: If the request body fails validation. Example: POST /api/v1/integrations/sandbox/events/fire { "eventType": "asset.processing.completed", "submissionId": "550e8400-e29b-41d4-a716-446655440000" } Response (200): { "dispatched": 2 }

POST /api/integrations/sandbox/events/fire

Fire Sandbox Event

cURL

curl --request POST \
  --url https://mm-midmarket-integrations-api-preview.azurewebsites.net/api/integrations/sandbox/events/fire \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "eventType": "asset.processing.completed",
  "submissionId": "550e8400-e29b-41d4-a716-446655440000"
}
'

200

{
  "dispatched": 123
}

Authorizations

X-API-Key · string · header · default: sk_live_your_api_key_here · required

Workspace-scoped API key. Format: sk_live_{64 hex chars}

Body

application/json

Request model for firing a synthetic sandbox webhook event.

eventType · enum<string> · required

The webhook event type to fire.

Available options: asset.processing.completed, asset.processing.failed

submissionId · string<uuid> · required

Submission UUID to embed in the event payload.

errorMessage · string | null

Error message forwarded to subscribers for 'asset.processing.failed' events. Defaults to 'Sandbox simulated failure' when omitted.

Response

200

application/json

Successful Response

Response model for a fired sandbox event.

dispatched · integer · required

Number of webhook subscriptions notified.