PromptUI Trigger icon

PromptUI Trigger

Receive and verify HMAC-signed PromptUI job-completion callbacks

PromptUI Trigger

AI-generated

Summary

Receives PromptUI job-completion callbacks over an HTTP POST webhook, verifies their HMAC signature and timestamp, and starts the workflow for matching statuses.

Inputs

  • Trigger On Statuses — Select statuses to emit, done and/or failed; defaults to both. Status matching is case-insensitive. Other verified statuses are acknowledged with HTTP 200 and do not start the workflow. An empty selection disables this status filter.
  • Timestamp Skew (Seconds) — Maximum difference allowed between the signed callback timestamp and the current time, in seconds; defaults to 300. Older or future timestamps outside this window are rejected.
  • PromptUI API credential (required) — Must include the server's callback secret (CALLBACK_SECRET) so the trigger can verify callbacks.

Output shape

One workflow item with a JSON object containing jobId, status, resultRef, error, and payload.

Missing callback fields are returned as null. Invalid or expired signatures receive HTTP 401 and do not start the workflow. The trigger reads the raw request body for signature verification; malformed JSON is treated as an empty object.

Links

Discussion