Reference · Tools

Venafi TLS Protect Cloud Trigger

Starts workflow when Venafi TLS Protect Cloud events occur

Webhook trigger Development v1

The Venafi TLS Protect Cloud Trigger fires when Venafi reports activity you have subscribed to, delivering an events array through its connector mechanism. A typical build is reacting the moment a certificate is issued or revoked so downstream systems stay in step.

Node type
Webhook trigger
Parameters
2
Outputs
Output
Credentials
Venafi TLS Protect Cloud

Venafi TLS Protect Cloud Trigger

Triggers on Venafi TLS Protect Cloud certificate and activity events

Overview

Receives webhook notifications from Venafi TLS Protect Cloud when certificate lifecycle and activity events occur. Venafi sends connector-based webhook POSTs containing an events array with message and eventName fields. The trigger supports filtering by activity type (resource) and specific sub-activity (trigger on), allowing fine-grained control over which certificate management events start a workflow. Handles Venafi connection test messages automatically. Useful for automating certificate renewal workflows, compliance alerting, certificate discovery notifications, and TLS infrastructure monitoring.

Category: Development
Tool Name: venafi_tls_protect_cloud_trigger
Version: 1

Appearance: Icon: lucide-ShieldCheck | Color: #333333

Node Type

Trigger — webhook (receives incoming HTTP callbacks)

Input / Output

DirectionPort(s)
InputNone (trigger node)
OutputOutput

Credentials

This tool requires Venafi TLS Protect Cloud credentials. See the Credentials Guide for setup instructions.

Parameters

ParameterTypeRequiredDefaultDescription
Resource (Activity Type)stringYesThe Venafi activity type key to subscribe to. This corresponds to an activity type from the Venafi /v1/activitytypes API endpoint. Examples: “certificateStatusNew”, “certificateStatusUpdate”, “certificateDiscovery”, “certificateProvisioning”. Enter the exact activity type key.
Trigger On (Activity Sub-Types)stringYes*Comma-separated list of activity sub-type keys to listen for, or ”*” to trigger on all sub-activities under the selected resource. Sub-types are specific event names within the activity type (e.g., “certificateExpiring”, “certificateRenewed”). Find available sub-types via the Venafi /v1/activitytypes API under the selected activity type’s “values” array.

Output Data

A Venafi delivery carries an events array, and the trigger emits one output item per matching event — a single POST can therefore start the workflow with several items.

Each item contains:

  • eventName — the Venafi event name, e.g. certificateExpiring
  • message — the human-readable activity message Venafi sent
  • _trigger — always venafi_tls_protect_cloud_webhook
  • _timestamp — ISO 8601 timestamp of when the delivery was received
  • _webhookEvent — the same value as eventName, or unknown when Venafi omitted it

All remaining fields of the individual event object are merged onto the item.

Events whose eventName is outside your Trigger On list are dropped; when nothing matches, the delivery is acknowledged without starting the workflow. Venafi’s TESTING CONNECTION... probe, sent when a connector is created, is acknowledged the same way. A POST without a non-empty events array is rejected.

Reference the payload downstream by expression, e.g. {{ $json.eventName }}.

Usage Examples

  • Start a workflow when a certificate is about to expire in Venafi
  • Trigger an alert when a new certificate is discovered by Venafi
  • Automate certificate renewal when Venafi detects expiration
  • Monitor certificate compliance violations in Venafi TLS Protect Cloud

Example Configuration

Every sub-activity under an activity type:

{
  "type": "venafi_tls_protect_cloud_trigger",
  "parameters": {
    "resource": "certificateStatusNew",
    "triggerOn": "*"
  }
}

Only selected sub-activities:

{
  "type": "venafi_tls_protect_cloud_trigger",
  "parameters": {
    "resource": "certificateStatusUpdate",
    "triggerOn": "certificateExpiring,certificateRenewed"
  }
}

Certificate discovery events:

{
  "type": "venafi_tls_protect_cloud_trigger",
  "parameters": {
    "resource": "certificateDiscovery",
    "triggerOn": "*"
  }
}

Trigger Behavior

  • Activation: When the workflow is activated, a webhook endpoint is registered with the service.
  • Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
  • Payload: The incoming webhook payload is parsed and output as workflow items.
  • Verification: Supports signature verification where applicable.

Tips

Entry point that fires when Venafi TLS Protect Cloud sends a webhook for subscribed activity events. Configure the activity type (resource) to select the category of events, then choose specific sub-activities to listen for, or select [All] to receive all events of that type. Venafi uses connectors to deliver webhook payloads containing an events array with message and eventName fields.

Frequently asked questions

How do I choose which events fire it?

Configure the activity type to select the category of events, then choose specific sub-activities — or select [All] to receive every event of that type.

How does Venafi deliver the payload?

Through connectors, which POST a payload containing an events array with message and eventName fields.

What is a typical use?

Keeping certificate inventory or downstream deployment in step with issuance and revocation, without polling for changes.

Which credential does it need?

A Venafi TLS Protect Cloud credential.

Build with the Venafi TLS Protect Cloud Trigger node

Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Venafi TLS Protect Cloud credentials first.

Open BusyBot

Last updated . Spotted something wrong? Tell us.