Skip to content
Proud to collaborate with Microsoft for Startups

stripe.webhooks.create_endpoint ​

Create a Stripe webhook endpoint and store its signing secret

Create a Stripe webhook endpoint on the customer's own Stripe account.

The signing secret is written into the connection secrets under store_secret_as and never persisted in state_data.

Inputs:

  • cloud_connection_uuid: Org-scoped Stripe connection.
  • url: Public HTTPS URL Stripe will POST to.
  • enabled_events: Event names to subscribe.
  • store_secret_as: Connection secret key that receives the whsec_… secret.
  • description, metadata, api_version: optional Stripe fields.

Outputs:

  • endpoint_id, status, url, enabled_events, secret_stored_as

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-stripe
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
cloud_connection_uuiduuidYes—Org-scoped Stripe connection (customer's own account)
urlstringYes—Public HTTPS URL Stripe will POST to
enabled_eventslistYes—Stripe event names to subscribe
store_secret_asstringYes—Connection secret key to write the endpoint signing secret under
workflow_run_idstringNo—DAG-stamped parent run id
descriptionstringNo—Endpoint description in the Stripe dashboard
metadatajsonNo—Arbitrary key-value metadata
api_versionstringNo—Stripe API version for event payloads

Output Schema ​

FieldTypeRequiredDefaultDescription
endpoint_idstringNo——
statusstringNo——
urlstringNo——
enabled_eventslistNo——
secret_stored_asstringNo——
cloud_connection_uuiduuidNo——
descriptionstringNo——
metadatajsonNo——
api_versionstringNo——
store_secret_asstringNo——
workflow_run_idstringNo——
failure_reasonstringNo——
failure_typestringNo——
failed_actionstringNo——
failed_at_statestringNo——
failed_stepstringNo——
errorstringNo——
error_typestringNo——
failed_layerintegerNo——

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

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

{
  "workflow_type": "stripe.webhooks.create_endpoint",
  "initial_data": {
    "cloud_connection_uuid": "value",
    "url": "value",
    "enabled_events": "value",
    "store_secret_as": "value"
  }
}