stripe.webhooks.validate_event

Validate a Stripe webhook signature and parse the event

Validate a Stripe webhook signature and parse the event.

The webhook originates from the CUSTOMER'S OWN Stripe account; the signing secret defaults from the org-scoped Stripe connection selected by cloud_connection_uuid, and can be overridden per run via webhook_secret.

Pass the raw request body (as a string) and the Stripe-Signature header value. This workflow does NOT call any Stripe API — it only performs local signature verification.

Inputs:

• cloud_connection_uuid: Org-scoped Stripe connection UUID (required).
• payload: Raw request body string (required).
• signature: Value of the Stripe-Signature HTTP header (required).
• webhook_secret: Webhook endpoint secret, e.g. whsec_ABC123 (optional — defaults to the secret stored on the Stripe connection).

Outputs (terminal state_data):

• event_id: str — Stripe event ID
• event_type: str — e.g. customer.subscription.created
• event_object: dict — the event's data.object payload
• livemode: bool — true for live events, false for test events

Connection required: cloud_connection_uuid — supplies the default webhook signing secret; there is no platform-key fallback.

Overview

Property	Value
Workflow type	Atomic
Library	App-stripe
Version	1.0

Input Schema

Field	Type	Required	Default	Description
cloud_connection_uuid	uuid	Yes	—	Org-scoped Stripe connection (customer's own account)
payload	string	Yes	—	Raw request body string
signature	string	Yes	—	Stripe-Signature header value
webhook_secret	string	No	—	Webhook endpoint secret (whsec_...); defaults to the secret stored on the connection

Output Schema

Field	Type	Required	Default	Description
event_id	string	No	—	—
event_object	dict	No	—	—
event_type	string	No	—	—
livemode	boolean	No	—	—
cloud_connection_uuid	uuid	No	—	—
payload	string	No	—	—
signature	string	No	—	—
webhook_secret	string	No	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "stripe.webhooks.validate_event",
  "initial_data": {
    "cloud_connection_uuid": "value",
    "payload": "value",
    "signature": "value"
  }
}